Hello, For sometime now, we have being considering how to improve on the current Puppet documentation available in the existing wiki. We knew that we needed to provide some curated documentation and that some of the curated documentation would be directly sourced from the wiki. We also wanted to encourage community engagement in the maintenance of the new documentation, because we believe strongly that community involvement makes better documentation. Bruce Williams took the time to migrate some of the current wiki pages into our new documentation format. He also setup the infrastructure to maintain the docs. Basically, we are storing the documents in a public git repo and treating the documentation just like any other community project. This serves two essential purposes. Firstly, Reductive Labs will play an active roll in shepherding the documentation. This is not unlike the roll we currently play in managing our other projects. Secondly, we hope that this will be a nice way for new community members to become familiar with our bug reporting and contribution processes. We have moved the following documentation over to the new docs.reductivelabs.com location: http://docs.reductivelabs.com/guides/introduction.html http://docs.reductivelabs.com/guides/installation.html http://docs.reductivelabs.com/references Notice that the reference documentation is now archived for older releases. We know that this it is not yet comprehensive documentation but it is a start. If you would like to contribute or provide feedback, we have outlined that process as well. http://docs.reductivelabs.com/contribute.html For the time being, the old wiki will remain essentially unchanged. We will gradually move appropriate content into docs. We will continue to provide a wiki for community documentation. We just believe that there is room for curated documentation as well. We expect that wiki documentation will be a place where the community develops new documentation that once vetted may be appropriate for the docs. Or a place for detailed "how to" style docs about a specific aspect of configuration management. As always, your feedback is encouraged. Cheers, Teyo -- Teyo Tyree :: www.reductivelabs.com :: +1.615.275.5066 -- 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.
On 1/14/10 8:28 AM, Teyo Tyree wrote:> Hello, > > For sometime now, we have being considering how to improve on the > current Puppet documentation available in the existing wiki. We knew > that we needed to provide some curated documentation and that some of > the curated documentation would be directly sourced from the wiki. We > also wanted to encourage community engagement in the maintenance of the > new documentation, because we believe strongly that community > involvement makes better documentation. > > Bruce Williams took the time to migrate some of the current wiki pages > into our new documentation format. He also setup the infrastructure toNice job! This is great. I wonder if you''ve considered making the documentation fit the style of the rest of the docs site, though? It seems more cohesive to me that way when browsing :) -scott -- 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.
> http://docs.reductivelabs.com/guides/introduction.htmlThere seems to be a glitch in http://docs.reductivelabs.com/guides/introduction.html#functions . -- 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-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org To unsubscribe from this group, send email to puppet-users+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org For more options, visit this group at http://groups.google.com/group/puppet-users?hl=en.
On Thu, Jan 14, 2010 at 10:50 AM, Andrew Schulman < google-groups-andrex@sneakemail.com> wrote:> > http://docs.reductivelabs.com/guides/introduction.html > > There seems to be a glitch in > http://docs.reductivelabs.com/guides/introduction.html#functions . > >I really like it, but the font size is too big for documentation imho. I''m finding myself zooming out, which I rarely do. Chrome and Safari on OS X. -- nigel -- 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.
Agreed. The font is too big. Other than that it''s great though. Good work On Jan 14, 2010, at 4:16 PM, Nigel Kersten wrote:> > > On Thu, Jan 14, 2010 at 10:50 AM, Andrew Schulman <google-groups-andrex@sneakemail.com> wrote: > > http://docs.reductivelabs.com/guides/introduction.html > > There seems to be a glitch in > http://docs.reductivelabs.com/guides/introduction.html#functions . > > > I really like it, but the font size is too big for documentation imho. I''m finding myself zooming out, which I rarely do. > > Chrome and Safari on OS X. > > > -- > nigel > -- > 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.
On Thu, Jan 14, 2010 at 2:19 PM, Carl Caum <carl.caum@gmail.com> wrote:> Agreed. The font is too big. Other than that it''s great though. Good work >I also have to say that I really appreciate the speed at which this loads compared to the old site too :)> On Jan 14, 2010, at 4:16 PM, Nigel Kersten wrote: > > > > On Thu, Jan 14, 2010 at 10:50 AM, Andrew Schulman < > google-groups-andrex@sneakemail.com> wrote: > >> > http://docs.reductivelabs.com/guides/introduction.html >> >> There seems to be a glitch in >> http://docs.reductivelabs.com/guides/introduction.html#functions . >> >> > I really like it, but the font size is too big for documentation imho. I''m > finding myself zooming out, which I rarely do. > > Chrome and Safari on OS X. > > > -- > nigel > -- > 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<puppet-users%2Bunsubscribe@googlegroups.com> > . > For more options, visit this group at > http://groups.google.com/group/puppet-users?hl=en. > >-- nigel -- 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.
> I also have to say that I really appreciate the speed at which this loads > compared to the old site too :)You''ve got that right. -- 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-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org To unsubscribe from this group, send email to puppet-users+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org For more options, visit this group at http://groups.google.com/group/puppet-users?hl=en.
On Thu, Jan 14, 2010 at 3:36 PM, Andrew Schulman < google-groups-andrex@sneakemail.com> wrote:> > I also have to say that I really appreciate the speed at which this loads > > compared to the old site too :) > > You''ve got that right. > >Thanks! We''re pretty happy with this new system -- and as Teyo pointed out, this is just the beginning of our plans for the curated documentation. There''s plenty of places where content needs to be extended (or fixed), and design and organization issues that will get ironed out over time. Something I''d really like to highlight is that this is an open source project like any other -- while we''ll be sorting through the mailing lists and GetSatisfaction forums we''ve integrated looking for actionable bugs and features to add as tickets to redmine[1], please feel free to add your own directly (just as you would with puppet, the dashboard, etc) -- and don''t forget we''re more than happy to accept content and design contributions[2] from the git-enabled. Cheers, Bruce [1]: http://projects.reductivelabs.com/projects/puppet-docs/issues [2]: http://docs.reductivelabs.com/contribute.html -- Bruce Williams http://reductivelabs.com -- 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.
Nigel Kersten <nigelk@google.com> writes:> Andrew Schulman <google-groups-andrex@sneakemail.com> wrote:>> There seems to be a glitch in >> http://docs.reductivelabs.com/guides/introduction.html#functions .> I really like it, but the font size is too big for documentation > imho. I''m finding myself zooming out, which I rarely do.> Chrome and Safari on OS X.Wow, with Firefox on Linux, the font is still too small, although it''s closer to being large enough than most web sites. screen #0: dimensions: 1600x1200 pixels (411x311 millimeters) resolution: 99x98 dots per inch -- Russ Allbery (rra@stanford.edu) <http://www.eyrie.org/~eagle/> -- 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.
I really like this new doc site, it looks like a clone of the Ruby doc site (which I quite like). It''s fast and the font looks fine to me. Thanks for all your hard work on this! -- 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.
On Fri, 15 Jan 2010 03:30:14 -0800 (PST) Richard Richard wrote:> I really like this new doc site, it looks like a clone of the Ruby doc > site (which I quite like). It''s fast and the font looks fine to me. > Thanks for all your hard work on this!+1 Cheers, Arnau -- 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.
re: font size. It looks fine to me on Safari 4 on the Mac. Note: for every year after 40 you need to press command-plus once :-) --- Thanks, Allan Marcus 505-667-5666 On Jan 14, 2010, at 9:28 AM, Teyo Tyree wrote:> Hello, > > For sometime now, we have being considering how to improve on the current Puppet documentation available in the existing wiki. We knew that we needed to provide some curated documentation and that some of the curated documentation would be directly sourced from the wiki. We also wanted to encourage community engagement in the maintenance of the new documentation, because we believe strongly that community involvement makes better documentation. > > Bruce Williams took the time to migrate some of the current wiki pages into our new documentation format. He also setup the infrastructure to maintain the docs. Basically, we are storing the documents in a public git repo and treating the documentation just like any other community project. This serves two essential purposes. Firstly, Reductive Labs will play an active roll in shepherding the documentation. This is not unlike the roll we currently play in managing our other projects. Secondly, we hope that this will be a nice way for new community members to become familiar with our bug reporting and contribution processes. > > We have moved the following documentation over to the new docs.reductivelabs.com location: > > http://docs.reductivelabs.com/guides/introduction.html > http://docs.reductivelabs.com/guides/installation.html > http://docs.reductivelabs.com/references > > Notice that the reference documentation is now archived for older releases. > > We know that this it is not yet comprehensive documentation but it is a start. If you would like to contribute or provide feedback, we have outlined that process as well. > > http://docs.reductivelabs.com/contribute.html > > For the time being, the old wiki will remain essentially unchanged. We will gradually move appropriate content into docs. We will continue to provide a wiki for community documentation. We just believe that there is room for curated documentation as well. We expect that wiki documentation will be a place where the community develops new documentation that once vetted may be appropriate for the docs. Or a place for detailed "how to" style docs about a specific aspect of configuration management. As always, your feedback is encouraged. > > Cheers, > Teyo > > -- > Teyo Tyree :: www.reductivelabs.com :: +1.615.275.5066 > -- > 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.
heh! On Jan 25, 2010, at 5:01 PM, Allan Marcus wrote:> re: font size. > > It looks fine to me on Safari 4 on the Mac. > > Note: for every year after 40 you need to press command-plus once :-) > > --- > Thanks, > > Allan Marcus > 505-667-5666-- 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.
While the new documentation site is "pretty", I agree with the other posts that the font is way too big. I''m using Firefox 3.5.6 in Fedora 12. I find the new documentation site to take much longer to navigate, both between pages and on a page. The load times are fine, the layout is in my opinion is highly inefficient and the same information that existed in the old wiki is much more spread out. I only took the time to find this thread because the old pages were damaged by the change. For example: The old wiki page looks like it did yesterday: http://reductivelabs.com/trac/puppet/wiki But the type reference page redirects out of the wiki to an ugly and older archived version: (all of the nagios types are flooding the document again) http://reductivelabs.com/trac/puppet/wiki/TypeReference I would be very happy if we could get the same copy of that page back that we had earlier this week. The old wiki is much more efficient for me to navigate. I appreciate your effort on the new documentation site. On Jan 14, 11:28 am, Teyo Tyree <t...@reductivelabs.com> wrote:> Hello, > > For sometime now, we have being considering how to improve on the current > Puppet documentation available in the existing wiki. We knew that we needed > to provide some curated documentation and that some of the curated > documentation would be directly sourced from the wiki. We also wanted to > encourage community engagement in the maintenance of the new documentation, > because we believe strongly that community involvement makes better > documentation. > > Bruce Williams took the time to migrate some of the current wiki pages into > our new documentation format. He also setup the infrastructure to maintain > the docs. Basically, we are storing the documents in a public git repo and > treating the documentation just like any other community project. This > serves two essential purposes. Firstly, Reductive Labs will play an active > roll in shepherding the documentation. This is not unlike the roll we > currently play in managing our other projects. Secondly, we hope that this > will be a nice way for new community members to become familiar with our bug > reporting and contribution processes. > > We have moved the following documentation over to the new > docs.reductivelabs.com location: > > http://docs.reductivelabs.com/guides/introduction.htmlhttp://docs.reductivelabs.com/guides/installation.htmlhttp://docs.reductivelabs.com/references > > Notice that the reference documentation is now archived for older releases. > > We know that this it is not yet comprehensive documentation but it is a > start. If you would like to contribute or provide feedback, we have > outlined that process as well. > > http://docs.reductivelabs.com/contribute.html > > For the time being, the old wiki will remain essentially unchanged. We will > gradually move appropriate content into docs. We will continue to provide > a wiki for community documentation. We just believe that there is room for > curated documentation as well. We expect that wiki documentation will be a > place where the community develops new documentation that once vetted may be > appropriate for the docs. Or a place for detailed "how to" style docs about > a specific aspect of configuration management. As always, your feedback is > encouraged. > > Cheers, > Teyo > > -- > Teyo Tyree ::www.reductivelabs.com:: +1.615.275.5066-- 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.
It would be nice if the page titles weren''t all "Puppet Docs." When I have multiple pages open in separate tabs, it''s difficult to find the page I want. -- 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.
> It would be nice if the page titles weren''t all "Puppet Docs." When I > have multiple pages open in separate tabs, it''s difficult to find the > page I want.The best idea is to fill feature requests on: http://projects.reductivelabs.com/projects/puppet-docs I assume it''s pretty hard to track feature requests in various mail threads. cheers pete -- 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.