I looked through that page and expected it to be under "About PerlMonks", which seemed to cover such general topics. When i looked at "Advanced PerlMonks Topics" i pretty much only read the first five titles and then assumed that the rest of it also was "How to do stuff on PM". Not actually anything about PM.
Since you took no care to be diplomatic or polite, I'll be blunt as well and say straight out that the FAQ is, at least in that respect, badly structured. | [reply] |
| [reply] |
ELISHEVA already offered me some support if i were to write something up on that topic and as time permits i will try to do at least a general review and opinion on better sorting of the FAQ within the next day. :)
| [reply] |
| [reply] |
I have to admit that it was my oversight not to search or Ctrl+F for "source" and instead rely on good old reading. (In my defense, it was rather late in the evening and english isn't my first language.)
However i think that pointing to the existence of such tools as a reason for lack of well-structured documentation is a rather weak excuse. Good documentation is a virtue of any developer, shouldn't PM go ahead with good example in that too?
| [reply] |
... if you didn't find this in the PerlMonks FAQ: ...
I think this might be in the same category as forgetting to look in the closet for the coat you wore last night. :-)
Best, beth
| [reply] |
