I agree. Getting the right balance of tutorial and and reference/usage is a hard to do and good thing. I personally prefer that Tutorial documents are seperate (but present) and that Reference documents are clear and concise. I even hacked Pod::Html to add extra indexes so that I have a list of items mentioned in the document for quicker lookups.

---
demerphq