One feature (IMHO) that would be a real treat to have in perl is something similar to Python Docstrings. Even though this is not a feature of perl, you may be able to get some ideas for modularizing your documentation by seeing how they do it in python-land. "Borrowing" conventions from them may be a way to gain some ideas. Just my 2 cents.