Re^3: Status of Recent User Information Leak

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.

Comment on Re^3: Status of Recent User Information Leak

Replies are listed 'Best First'.
Re^4: Status of Recent User Information Leak by jdporter (Paladin) on Aug 04, 2009 at 11:23 UTC
...the FAQ is, at least in that respect, badly structured. No argument there! If you have suggestions for how the structure could be improved, they will be gratefully received. Thanks! Between the mind which plans and the hands which build, there must be a mediator... and this mediator must be the heart.	[reply]
Re^5: Status of Recent User Information Leak by Xenofur (Monk) on Aug 04, 2009 at 11:29 UTC
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]
Re^4: Status of Recent User Information Leak by Anonymous Monk on Aug 04, 2009 at 10:44 UTC
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. When you visit PerlMonks FAQ, search form is right on top. If you type in source code (or source code ) you'll find Can I get the PerlMonks source code?. Badly structured? It doesn't matter.	[reply]
Re^5: Status of Recent User Information Leak by Xenofur (Monk) on Aug 04, 2009 at 11:05 UTC
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]
Re^6: Status of Recent User Information Leak by Anonymous Monk on Aug 04, 2009 at 11:19 UTC
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? 1) never concedeed it is weakly structured 2) never proffer search as an excuse 3) it is simple fact of computers, if you don't search, you're reading books :)	[reply]
Re^7: Status of Recent User Information Leak by Xenofur (Monk) on Aug 04, 2009 at 11:31 UTC


Perl-Sensitive Sunglasses
	PerlMonks