Puppet users - Dec 2009 - /wiki/TypeReference is slow/timing out

It takes a really long time for
http://reductivelabs.com/trac/puppet/wiki/TypeReference to render. 
I''ve
noticed it for a while, but today for the first time it actually timed out
on me.

Any idea what''s making this page take so long?  Is it just too much
restructured text?  It is a very long page.

If that is the case, then I have a suggestion to alleviate the problem:
move the nagios_* types onto a separate page.  For those of us who
don''t
use Nagios, those types are a giant lump in the middle of a very long page.

Thanks,
Andrew.

--

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 Dec 2, 2009, at 11:12 AM, Andrew Schulman wrote:
> It takes a really long time for
> http://reductivelabs.com/trac/puppet/wiki/TypeReference to render.   
> I''ve
> noticed it for a while, but today for the first time it actually  
> timed out
> on me.
>
> Any idea what''s making this page take so long?  Is it just too
much
> restructured text?  It is a very long page.
>
> If that is the case, then I have a suggestion to alleviate the  
> problem:
> move the nagios_* types onto a separate page.  For those of us who  
> don''t
> use Nagios, those types are a giant lump in the middle of a very  
> long page.

We''re in the process of moving these pages to a static, external  
format, based on RailsGuides.  I don''t have a specific time on getting
it done, but this is one of Bruce''s main focuses at the moment, so I  
expect he''ll get it working quickly.

The problem, at this point, with moving the Nagios docs elsewhere is  
that the page is all autogenerated.  It''s a good point, though, that  
we could pretty easily manually do so.

If someone wants to edit those docs for now to do exactly that, that  
might be a good interim step, while we''re waiting for Bruce''s
work to
come through.

-- 
I don''t want the world, I just want your half.
---------------------------------------------------------------------
Luke Kanies | http://reductivelabs.com | http://madstop.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.

hello,

----- "Luke Kanies" <luke@madstop.com> wrote:
> On Dec 2, 2009, at 11:12 AM, Andrew Schulman wrote:
> 
> > It takes a really long time for
> > http://reductivelabs.com/trac/puppet/wiki/TypeReference to render.  
> 
> > I''ve
> > noticed it for a while, but today for the first time it actually  
> > timed out
> > on me.
> >
> > Any idea what''s making this page take so long?  Is it just
too much
> > restructured text?  It is a very long page.
> >
> > If that is the case, then I have a suggestion to alleviate the  
> > problem:
> > move the nagios_* types onto a separate page.  For those of us who 
> 
> > don''t
> > use Nagios, those types are a giant lump in the middle of a very  
> > long page.
> 
> 
> We''re in the process of moving these pages to a static, external  
> format, based on RailsGuides.  I don''t have a specific time on
getting
> it done, but this is one of Bruce''s main focuses at the moment, so
I
> expect he''ll get it working quickly.
I have a archive of various versions of type/function references here:

http://nephilim.ml.org/~rip/puppet/historical/

You can also use ''puppetdoc'' that should be in the tarball
make your own, or see the docs using the pi executable by just doing:

$ pi nagios_service

--

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 takes a really long time for
> > http://reductivelabs.com/trac/puppet/wiki/TypeReference to render.   
> > I''ve
> > noticed it for a while, but today for the first time it actually  
> > timed out
> > on me.
> 
> We''re in the process of moving these pages to a static, external  
> format, based on RailsGuides.  I don''t have a specific time on
getting
> it done, but this is one of Bruce''s main focuses at the moment, so
I
> expect he''ll get it working quickly.
OK, thanks.  I don''t know RailsGuides, but just looking around, it
seems
that it uses Textile.  So will all of the wiki docs be converting to
Textile?

I don''t relish converting the module docs that I''ve already
built, but I
can''t say I''d be sorry to say goodbye to restructured text. 
If Bruce is
developing an automated conversion tool for restructured -> Textile, it
would be great if he''d make it available.
> The problem, at this point, with moving the Nagios docs elsewhere is  
> that the page is all autogenerated.  It''s a good point, though,
that
> we could pretty easily manually do so.
> 
> If someone wants to edit those docs for now to do exactly that, that  
> might be a good interim step, while we''re waiting for
Bruce''s work to
> come through.
OK.  If there''s no objection I''ll do it.

--

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.

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Andrew Schulman wrote:
>>> It takes a really long time for
>>> http://reductivelabs.com/trac/puppet/wiki/TypeReference to render.
>>> I''ve
>>> noticed it for a while, but today for the first time it actually  
>>> timed out
>>> on me.
>> We''re in the process of moving these pages to a static,
external
>> format, based on RailsGuides.  I don''t have a specific time on
getting
>> it done, but this is one of Bruce''s main focuses at the
moment, so I
>> expect he''ll get it working quickly.
> 
> OK, thanks.  I don''t know RailsGuides, but just looking around, it
seems
> that it uses Textile.  So will all of the wiki docs be converting to
> Textile?
Probably the docs - though the internal documentation will remain
RST.  You can already generate the internal docs with HTML,
Markdown, RST, etc. It''d be easy to add Textile to that.
>> If someone wants to edit those docs for now to do exactly that, that  
>> might be a good interim step, while we''re waiting for
Bruce''s work to
>> come through.
> 
> OK.  If there''s no objection I''ll do it.
I''ve done it:

http://reductivelabs.com/trac/puppet/wiki/TypeReference
http://reductivelabs.com/trac/puppet/wiki/NagiosReference

Thanks

James Turnbull

- --
Author of:
* Pro Linux System Administration (http://tinyurl.com/linuxadmin)
* Pulling Strings with Puppet (http://tinyurl.com/pupbook)
* Pro Nagios 2.0 (http://tinyurl.com/pronagios)
* Hardening Linux (http://tinyurl.com/hardeninglinux)
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.7 (Darwin)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQEVAwUBSxbLzSFa/lDkFHAyAQLTGQgAiLxd99fBIEIlwVuMeY3rgJmGflM0r7K4
NVa1uyd2eARzIfi5X636ecQAPRpHxvzmbJGi4YfuN7Lswsf8AJG1Nx8vgw5L0W3m
dC/MqSZGfjn9Sk7ByKDKIHfT/zo/u0Z85irPPErimw4u8ck8W2G6gttg7ptnkBg8
fLEtrbAS2eJQbKnVLwlTwjuOOFvKcysc71+W/fFOoLNETDZybqOxss3mGeQkHD9Z
26gb9qsLVBI0EzysSPl4GidDX+ChEjsA6fzdJ9qGXB1X9oIdw3Plt//b38MF8UV7
vXMxJJ2v/rEJh2DcA5Bt86O9nhTBPyybiO0E937mZ7WisdAxxSjehg==OP+h
-----END PGP SIGNATURE-----

--

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.

> >> If someone wants to edit those docs for now to do exactly that,
that
> >> might be a good interim step, while we''re waiting for
Bruce''s work to
> >> come through.
> > 
> > OK.  If there''s no objection I''ll do it.
> 
> I''ve done it:
> 
> http://reductivelabs.com/trac/puppet/wiki/TypeReference
> http://reductivelabs.com/trac/puppet/wiki/NagiosReference
Thanks.  The TypeReference page is loading much faster now.

--

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 Dec 2, 2009, at 11:51 AM, Andrew Schulman wrote:
>>> It takes a really long time for
>>> http://reductivelabs.com/trac/puppet/wiki/TypeReference to render.
>>> I''ve
>>> noticed it for a while, but today for the first time it actually
>>> timed out
>>> on me.
>>
>> We''re in the process of moving these pages to a static,
external
>> format, based on RailsGuides.  I don''t have a specific time on
>> getting
>> it done, but this is one of Bruce''s main focuses at the
moment, so I
>> expect he''ll get it working quickly.
>
> OK, thanks.  I don''t know RailsGuides, but just looking around, it
> seems
> that it uses Textile.  So will all of the wiki docs be converting to
> Textile?
Looks like Bruce will be modifying RailsGuides to use Markdown, and  
we''ll use that.
> I don''t relish converting the module docs that I''ve
already built,
> but I
> can''t say I''d be sorry to say goodbye to restructured
text.  If
> Bruce is
> developing an automated conversion tool for restructured -> Textile,  
> it
> would be great if he''d make it available.
One of the reasons for using Markdown, in addition to it generally  
being a better format, is that we can''t seem to find rst2textile  
converters, but it''s easyish to do rst2markdown.

[...]

-- 
The intelligent man finds almost everything ridiculous, the sensible
man hardly anything. -- Johann Wolfgang von Goethe
---------------------------------------------------------------------
Luke Kanies | http://reductivelabs.com | http://madstop.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.

On Thu, Dec 3, 2009 at 11:53 AM, Luke Kanies <luke@madstop.com> wrote:
>
> Looks like Bruce will be modifying RailsGuides to use Markdown, and
> we''ll use that.
>
Github-flavored Markdown? Makes a few tweaks to standard Markdown that
are a Good Thing for code-centric documentation.

cheers
rob

--

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.