Issue #7601 has been updated by Nick Fagerlund.

We actually used to have a one-page-per-type version of the type reference. I 
burned it to the ground, because it'd been created by hand and was many many 
versions out of sync with reality (and had no concept of versioning at all, 
come to think of it). 

I'm sure we could find a way to do it maintainably; it's just a question of 
whether that would actually enhance the usefulness of the reference. That's 
what I'd most like more feedback about. 

I'm very interested in Thomas's suggestion of using DL elements instead of h5s, 
especially since I think that would eliminate a lot of the element ID 
conflicts! I also think the Markdown dialect Jekyll is using has extended 
syntax for those, so that's nice. I'll look into this. 
----------------------------------------
Bug #7601: Long online docs pages should be broken up
https://projects.puppetlabs.com/issues/7601

Author: Randall Hansen
Status: Investigating
Priority: Normal
Assignee: 
Category: 
Target version: 
Keywords: puppetcamp-eu-2011
Branch: 
Affected URL: 


Our very long docs pages are difficult to use.  E.g., 
[http://docs.puppetlabs.com/references/2.6.8/type.html](http://docs.puppetlabs.com/references/2.6.8/type.html)

--

*This ticket is a request for comment, coming out of a discussion at Puppet 
Camp EU, 2011.  No promises whatever about implementation, but there were 
enough people interested to open a public discussion.*



-- 
You have received this notification because you have either subscribed to it, 
or are involved in it.
To change your notification preferences, please click here: 
http://projects.puppetlabs.com/my/account

-- 
You received this message because you are subscribed to the Google Groups 
"Puppet Bugs" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/puppet-bugs?hl=en.

Reply via email to