To quote something BrowserUk said a few months ago ... The point of this place ...

Don't take this the wrong way--I actually agree with you that the Perldocs could do with (links) to more examples--but there is a distinct and extremely important difference between this place and the Perldocs.

I'm not sure if it is a limitation of POD; the MAN format; or simply tuits; but the biggest limitation of the Perldocs is not content, but structure.

Given the hierarchal nature of HTML, it would be really nice to utilise that to have a keyword index; that linked keywords to summary descriptions; that linked to basic examples; that linked to expanded discussion; that linked to error messages and common pitfalls.

Probably the best producers of program and language documentation (that I've encountered), were the long defunct guys and gals at DEC. Besides that they appreciated the difference between understanding a subject and being able to convey it; their greatest skill was knowing that sometimes removing words is better than adding them.