hobo_bootstrap is getting big enough that it would be nice if the taglibs were nicely organized, à la Hobo Rapid.
aka: multiple subdirectories denoting 'sections'. Each directory has a simlarly named DRYML file, the first comment of which becomes the "section documentation introduction". Each tag is placed in its own file in a subdirectory, where the tag-name used for the filename.
suggestions for sections:
page, nav: these two sections are the theme proper
style (?): this section contains all the tags/extends that exist mostly just to add new classes to existing tags
forms, ...: sections that contain enhanced functionality
regardless of whether we do the reorg or not, we need to ensure that all tags are documented, or deliberately undocumented via <%# nodoc. %> All tags/extends that just exist to add a class or two to an existing tag should be marked nodoc.
iox
commented
12 years ago
hobo_bootstrap is getting big enough that it would be nice if the taglibs were nicely organized, à la Hobo Rapid.
aka: multiple subdirectories denoting 'sections'. Each directory has a simlarly named DRYML file, the first comment of which becomes the "section documentation introduction". Each tag is placed in its own file in a subdirectory, where the tag-name used for the filename.
suggestions for sections:
page, nav: these two sections are the theme proper style (?): this section contains all the tags/extends that exist mostly just to add new classes to existing tags forms, ...: sections that contain enhanced functionality
regardless of whether we do the reorg or not, we need to ensure that all tags are documented, or deliberately undocumented via
<%# nodoc. %>All tags/extends that just exist to add a class or two to an existing tag should be marked nodoc.