in reply to Re^6: Can I please have *simple* modules?
in thread Can I please have *simple* modules?
It might well help, if the sub-modules were well organized. If I was doing POSIX compliant file manipulations, for example, I wouldn't bother reading the manual for the date manipulation and timezone handling sub-module.
Sure the total amount of documentation is the same: but the number of lines of documentation that I need to read in order to solve my problems is decreased if the modules are better organized. It's really the same principle that leads us to we split our code into modules in the first place. If you split code (or documentation) up into logically ordered pieces, then you only have to read the code (or documentation) that applies to what you're working on; not the entire program (or manual page). If done right, it can save a lot of time and effort
--
Ytrew Q. Uiop
|
|---|
| Replies are listed 'Best First'. | |
|---|---|
|
Re^8: Can I please have *simple* modules?
by Perl Mouse (Chaplain) on Nov 25, 2005 at 22:52 UTC |