Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

organize taglibs directory #16

Open
bryanlarsen opened this issue Oct 18, 2012 · 1 comment
Open

organize taglibs directory #16

bryanlarsen opened this issue Oct 18, 2012 · 1 comment

Comments

@bryanlarsen
Copy link
Member

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
Copy link
Member

iox commented Oct 19, 2012

Good suggestions, +1.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants