Here's a suggestion for a formal documentation structure to help Lenya users grok the directory hierarchy and the interaction of files in Lenya. Ideally, each file gets a comment header and each directory contains a README file that will list the following information for files and directories respectively:
parsed during
${renderedContent}
parsed by
${renderedContent}
scope
${renderedContent}
overrides
${renderedContent}
can be overriden by
${renderedContent}
manual modification
${renderedContent}
manual modification implies
${renderedContent}
modified/generated by
${renderedContent}
If we can agree on a scheme like this, we might eventually apply it to solve the mysteries of DirectoryStructureLenya2.0-HEAD.