How can the perl documentation be better?

1. Perl docs {sux|rulez}
brian d foy
The Perl Review

4. Where
do you find
variable scoping?
(it’s not in perlvar)

5. Where
do you find
variable naming?
(it’s not in perlvar)

6. perldoc -f
perldoc -v

7. operators?
methods?
switches?

11. Reference
Tutorials
Alternate Tutorials
Topic Overviews
Quick Starts
FAQ
Lingua

12. perl perltoc perlartistic perlbook
perlcommunity perldebug
perldoc perlgpl
perlglossary perlhist perlintro
perlpolicy perlrepository perltodo perlutil

13. perl5004delta perl5005delta perl5100delta perl5101delta
perl5110delta perl5111delta perl5112delta perl5113delta
perl5114delta perl5115delta perl5120delta perl5121delta
perl5122delta perl5130delta perl5131delta perl5132delta
perl5133delta perl5134delta perl5135delta perl5136delta
perl561delta perl56delta perl570delta perl571delta
perldelta
perl572delta perl573delta perl581delta perl582delta
perl583delta perl584delta perl585delta perl586delta
perl587delta perl588delta perl589delta perl58delta
perl590delta perl591delta perl592delta perl593delta
perl594delta perl595delta

14. perlaix perlamiga perlapollo perlbeos perlbs2000 perlce
perlcygwin perldgux perldos perlebcdic perlepoc
perlfreebsd perlhaiku perlhpux perlhurd perlirix perllinux
perlmacos perlmacosx perlmpeix perlnetware perlopenbsd
perlos2 perlos390 perlos400 perlplan9 perlqnx perlriscos
perlsolaris perlsymbian perltru64 perluts perlvmesa
perlvms perlvos

15. perlapi
perlapio
perlcall
perlclib
perlembed
perlguts
perlhack
perlintern
perliol
perlmroapi
perlxs
perlxstut

16. perlfaq
perlfaq1
perlfaq2
perlfaq3
perlfaq4
perlfaq5
perlfaq6
perlfaq7
perlfaq8
perlfaq9

17. perlboot
perlbot
perlmod
perlmodinstall
perlmodlib
perlmodstyle
perlnewmod
perlobj
perltooc
perltoot

18. perlfaq
perlfaq1
perlfaq2
perlfaq3
perlfaq4
perlfaq5
perlfaq6
perlfaq7
perlfaq8
perlfaq9

19. perlre
perlreapi
perlrebackslash
perlrecharclass
perlrequick
perlreref
perlretut
perlreguts

20. perldsc
perldebtut
perlopentut
perlpacktut
perlreftut
perlthrtut

21. perlunicode
perlunifaq
perluniintro
perluniprops
perlunitut

22. perlcn
perljp
perlko
perltw

23. perldata perldiag perldebguts perldbmfilter perlipc
perllocale perlpod perlpodspec perllol perlnumber perlop
perlfilter perlfork perlform perlfunc perllexwarn
perlpragma perlref perlrun perlsub perlsyn perltie perlvar

24. now → ?

25. perl is in git
(perlrepository)

26. I’m a committer

27. Docs are for the
current version

28. perlfaq back in perl

29. books out of
perlfaq2
into
perlbook

30. perlvar reordered,
variable birth
documented

31. perlexperiment
lists iffy
features

32. a new perlop

33. perlkeyword

34. Other happenings
• “Perl Documentation Team”
• Updates to perlipc