Randall Hansen
2011-May-20 20:18 UTC
[Puppet Users] PC EU feedback: long online docs pages should be broken up
http://projects.puppetlabs.com/issues/7601 Our very long docs pages are difficult to use. E.g., http://docs.puppetlabs.com/references/2.6.8/type.html Please comment on the ticket or reply here, whichever you prefer. Thanks! r P.S. This is in response to feedback from my "Improving the Puppet DSL" session at Puppet Camp EU, 2011. This ticket isn''t a promise we will take action, but we could very much like comment and discussion from you good people. -- You received this message because you are subscribed to the Google Groups "Puppet Users" group. To post to this group, send email to puppet-users@googlegroups.com. To unsubscribe from this group, send email to puppet-users+unsubscribe@googlegroups.com. For more options, visit this group at http://groups.google.com/group/puppet-users?hl=en.
Nicolas Jungers
2011-May-21 06:57 UTC
Re: [Puppet Users] PC EU feedback: long online docs pages should be broken up
On 2011-05-20 22:18, Randall Hansen wrote:> http://projects.puppetlabs.com/issues/7601 > > Our very long docs pages are difficult to use. E.g., > http://docs.puppetlabs.com/references/2.6.8/type.htmlI''d disagree on one point. It''s not the length of the page that bother me, because having all on one page is indeed convenient. But the disappearance of the left margin when using a tight browser window (firefox 3.6) is annoying. A nice bonus would be to have the content list floating alongside the main view, but that''s a bit tricky when the content is longer that the window height. Regards, N.> > Please comment on the ticket or reply here, whichever you prefer. > > Thanks! > > r > > P.S. This is in response to feedback from my "Improving the Puppet > DSL" session at Puppet Camp EU, 2011. This ticket isn''t a promise we > will take action, but we could very much like comment and discussion > from you good people. >-- You received this message because you are subscribed to the Google Groups "Puppet Users" group. To post to this group, send email to puppet-users@googlegroups.com. To unsubscribe from this group, send email to puppet-users+unsubscribe@googlegroups.com. For more options, visit this group at http://groups.google.com/group/puppet-users?hl=en.
R.I.Pienaar
2011-May-21 07:01 UTC
Re: [Puppet Users] PC EU feedback: long online docs pages should be broken up
----- Original Message -----> On 2011-05-20 22:18, Randall Hansen wrote: > > http://projects.puppetlabs.com/issues/7601 > > > > Our very long docs pages are difficult to use. E.g., > > http://docs.puppetlabs.com/references/2.6.8/type.html > > I''d disagree on one point. It''s not the length of the page that > bother me, because having all on one page is indeed convenient. But the > disappearance of the left margin when using a tight browser window > (firefox 3.6) is annoying. A nice bonus would be to have the content > list floating alongside the main view, but that''s a bit tricky when > the content is longer that the window height.+1 the length is not the problem, in fact I too prefer it all on one page. The problem is in the TOC as indicated above but also since the TOC is simply wrong in some cases. -- You received this message because you are subscribed to the Google Groups "Puppet Users" group. To post to this group, send email to puppet-users@googlegroups.com. To unsubscribe from this group, send email to puppet-users+unsubscribe@googlegroups.com. For more options, visit this group at http://groups.google.com/group/puppet-users?hl=en.
Patrick Mohr
2011-May-21 07:13 UTC
Re: [Puppet Users] PC EU feedback: long online docs pages should be broken up
On Sat, May 21, 2011 at 12:01 AM, R.I.Pienaar <rip@devco.net> wrote:> > > ----- Original Message ----- > > On 2011-05-20 22:18, Randall Hansen wrote: > > > http://projects.puppetlabs.com/issues/7601 > > > > > > Our very long docs pages are difficult to use. E.g., > > > http://docs.puppetlabs.com/references/2.6.8/type.html > > > > I''d disagree on one point. It''s not the length of the page that > > bother me, because having all on one page is indeed convenient. But the > > disappearance of the left margin when using a tight browser window > > (firefox 3.6) is annoying. A nice bonus would be to have the content > > list floating alongside the main view, but that''s a bit tricky when > > the content is longer that the window height. > > +1 the length is not the problem, in fact I too prefer it all on one page. > >I actually second this. I like having them all on one page. -- You received this message because you are subscribed to the Google Groups "Puppet Users" group. To post to this group, send email to puppet-users@googlegroups.com. To unsubscribe from this group, send email to puppet-users+unsubscribe@googlegroups.com. For more options, visit this group at http://groups.google.com/group/puppet-users?hl=en.
Nathan Clemons
2011-May-21 11:07 UTC
Re: [Puppet Users] PC EU feedback: long online docs pages should be broken up
I don''t think the issue is necessarily that it''s all on one page, the hard part for me is that one section bleeds into the next section. It''s hard to tell where one leaves off and the next one starts. Some form of break between sections would make it much more readable. -- Nathan Clemons http://www.livemocha.com The worlds largest online language learning community On Fri, May 20, 2011 at 1:18 PM, Randall Hansen <randall@puppetlabs.com>wrote:> http://projects.puppetlabs.com/issues/7601 > > Our very long docs pages are difficult to use. E.g., > http://docs.puppetlabs.com/references/2.6.8/type.html > > Please comment on the ticket or reply here, whichever you prefer. > > Thanks! > > r > > P.S. This is in response to feedback from my "Improving the Puppet > DSL" session at Puppet Camp EU, 2011. This ticket isn''t a promise we > will take action, but we could very much like comment and discussion > from you good people. > > -- > You received this message because you are subscribed to the Google Groups > "Puppet Users" group. > To post to this group, send email to puppet-users@googlegroups.com. > To unsubscribe from this group, send email to > puppet-users+unsubscribe@googlegroups.com. > For more options, visit this group at > http://groups.google.com/group/puppet-users?hl=en. > >-- You received this message because you are subscribed to the Google Groups "Puppet Users" group. To post to this group, send email to puppet-users@googlegroups.com. To unsubscribe from this group, send email to puppet-users+unsubscribe@googlegroups.com. For more options, visit this group at http://groups.google.com/group/puppet-users?hl=en.