Hi all,
Peter Abrahamsen has duplicated all of the documentation and cookbook
pages in Puppet''s Trac page:
https://reductivelabs.com/trac/puppet/wiki/DocumentationStart
Please let me or Peter know if there are any problems.
--
A motion to adjourn is always in order.
--Robert Heinlein
---------------------------------------------------------------------
Luke Kanies | http://reductivelabs.com | http://madstop.com
Luke,
Have the Language Reference and Type Reference sections been replicated? They
seem to currently be links to missing Trac pages.
Thank you,
-- Rob --
----- Original Message ----
From: Luke Kanies <luke@madstop.com>
To: Puppet User Discussion <puppet-users@madstop.com>
Sent: Thursday, January 18, 2007 4:56:23 AM
Subject: [Puppet-users] Docs moved to Trac
Hi all,
Peter Abrahamsen has duplicated all of the documentation and cookbook
pages in Puppet''s Trac page:
https://reductivelabs.com/trac/puppet/wiki/DocumentationStart
Please let me or Peter know if there are any problems.
--
A motion to adjourn is always in order.
--Robert Heinlein
---------------------------------------------------------------------
Luke Kanies | http://reductivelabs.com | http://madstop.com
_______________________________________________
Puppet-users mailing list
Puppet-users@madstop.com
https://mail.madstop.com/mailman/listinfo/puppet-users
____________________________________________________________________________________
Cheap talk?
Check out Yahoo! Messenger''s low PC-to-Phone call rates.
http://voice.yahoo.com
_______________________________________________
Puppet-users mailing list
Puppet-users@madstop.com
https://mail.madstop.com/mailman/listinfo/puppet-users
Robert, They haven''t, you''re right. The API docs are a separate project, because they''re auto-generated in a markup format that isn''t what Trac uses. For this reason, there are also a lot of references to the API (reference) docs throughout the regular docs that will have to be re-added once we know how to reference them. This is my biggest qualm with the automagical code stuff--it''s impossible to use standard utilities to document them, generate ctags, and so forth. That, and debugging. It''s workable on a code base of this size, but I''ve worked on a larger project that worked the same way, and I hurt my head when I tried to figure out where all the auto-generated methods were coming from. Which, of course, is totally off-topic. Everyone, feel free to file me some bugs if there''s something that needs to be done with the docs, but you can''t/won''t do it yourself. Cheers, P Robert Mombro wrote:> Luke, > > Have the Language Reference and Type Reference sections been > replicated? They seem to currently be links to missing Trac pages. > > Thank you, > > -- Rob --
Peter, Thank you for the clarification. In this case, can the original documents be put back on the reductivelabs site until they''re fully moved? The main page no longer provides obvious access to the two references. Thank you, -- Rob -- ----- Original Message ---- From: Peter Abrahamsen <peter@betcha.com> To: puppet-users@madstop.com Sent: Thursday, January 18, 2007 2:46:33 PM Subject: Re: [Puppet-users] Docs moved to Trac Robert, They haven''t, you''re right. The API docs are a separate project, because they''re auto-generated in a markup format that isn''t what Trac uses. For this reason, there are also a lot of references to the API (reference) docs throughout the regular docs that will have to be re-added once we know how to reference them. This is my biggest qualm with the automagical code stuff--it''s impossible to use standard utilities to document them, generate ctags, and so forth. That, and debugging. It''s workable on a code base of this size, but I''ve worked on a larger project that worked the same way, and I hurt my head when I tried to figure out where all the auto-generated methods were coming from. Which, of course, is totally off-topic. Everyone, feel free to file me some bugs if there''s something that needs to be done with the docs, but you can''t/won''t do it yourself. Cheers, P Robert Mombro wrote:> Luke, > > Have the Language Reference and Type Reference sections been > replicated? They seem to currently be links to missing Trac pages. > > Thank you, > > -- Rob --_______________________________________________ Puppet-users mailing list Puppet-users@madstop.com https://mail.madstop.com/mailman/listinfo/puppet-users ____________________________________________________________________________________ Finding fabulous fares is fun. Let Yahoo! FareChase search your favorite travel sites to find flight and hotel bargains. http://farechase.yahoo.com/promo-generic-14795097 _______________________________________________ Puppet-users mailing list Puppet-users@madstop.com https://mail.madstop.com/mailman/listinfo/puppet-users
On Jan 19, 2007, at 2:22 AM, Robert Mombro wrote:> Luke, > > Have the Language Reference and Type Reference sections been > replicated? They seem to currently be links to missing Trac pages.Done: http://reductivelabs.com/projects/puppet/reference/index.html -- If computers get too powerful, we can organize them into a committee -- that will do them in. -- Bradley''s Bromide --------------------------------------------------------------------- Luke Kanies | http://reductivelabs.com | http://madstop.com
On Jan 19, 2007, at 6:46 AM, Peter Abrahamsen wrote:> Robert, > > They haven''t, you''re right. The API docs are a separate project, > because > they''re auto-generated in a markup format that isn''t what Trac > uses. For > this reason, there are also a lot of references to the API (reference) > docs throughout the regular docs that will have to be re-added once we > know how to reference them.I think we''ll always have to use code to extract the docs. At this point, I think we should just move from storing the internal docs in Markdown to storing them in Restructured Text. At least then we could put them in the Trac wiki, although someone would have to load them manually.> This is my biggest qualm with the automagical code stuff--it''s > impossible to use standard utilities to document them, generate ctags, > and so forth. That, and debugging. It''s workable on a code base of > this > size, but I''ve worked on a larger project that worked the same way, > and > I hurt my head when I tried to figure out where all the auto-generated > methods were coming from.Yeah, I know it can be complicated, but *most* of what I''m generating is actually classes, not methods.> Which, of course, is totally off-topic. > > Everyone, feel free to file me some bugs if there''s something that > needs > to be done with the docs, but you can''t/won''t do it yourself.Dude, it''s a wiki now, everyone can just do it themselves. :) -- Nature and nature''s laws lay hid in night, God said, "Let Newton be," and all was light. It did not last; the devil howling "Ho! Let Einstein be!" restored the status quo. --------------------------------------------------------------------- Luke Kanies | http://reductivelabs.com | http://madstop.com