in reply to Re^2: Status of Recent User Information Leak
in thread 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]
      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
[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]
        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]

In Section Perl Monks Discussion