I'll be constructive.
The first question that rose with me was "There's read-only and read-write configuration; which do I create/modify?" (it's probably the read-only file).
Under the title "Configuration obtained from the MiniMyth configuration file" it says "The MiniMyth configuration file is called 'minimyth.conf'." Maybe it's better to say "the read-only configuration file blabla etc", to avoid confusion.
In the next paragraph, you say "The MiniMyth configuration package is called 'minimyth.pm'.". Now it becomes clear after a while that this means a Perl package etcetera, but I think it's best to clearly state from the start of the paragraph "by 'package' we mean a programmers concept in the Perl language; so this configuration option is here for people with programming experience who need more control and want to customize the way Minimyth is configured". I would also try to avoid reverse chronological descriptions like "At startup, MiniMyth executes the package's 'start' method after retrieving and importing (but not processing) the MiniMyth configuration file and after updating DHCP configuration.".
At last, the documentation sums up all configuration methods and all options you can use in each method, (=typical "man page" approach"), but the most useful thing to add is, I think, a short intro about what CAN be changed and what absolutely NEEDS to be changed. It would also be useful to state here what you can expect from a bootable Minimyth in its default configuration. I, for example, do not know if a prompt saying
Code: Select all
I'd happily write this up, if I knew how to actually get Minimyth working