Re: [Puppet Users] Documentation contribution opportunity - Please help!

2010-08-31 Thread James Turnbull
Daniel Bahena wrote: > I can also chip in when this translation project starts. > > Best regards, So how would people like to contribute documentation in other languages? I can create a structure in the current docs directory tree like: http://github.com/reductivelabs/puppet-docs source/eng/..

Re: [Puppet Users] Documentation contribution opportunity - Please help!

2010-08-31 Thread Daniel Bahena
I can also chip in when this translation project starts. Best regards, -- Daniel Bahena Twitter: @informatux On Tue, Aug 31, 2010 at 12:47 AM, Jesús Couto wrote: > If an effort to translate the docs to Spanish get under way, I can help. > -- > -- > > Jesús Couto F.

Re: [Puppet Users] Documentation contribution opportunity - Please help!

2010-08-31 Thread Jesús Couto
If an effort to translate the docs to Spanish get under way, I can help. -- -- Jesús Couto F. -- You received this message because you are subscribed to the Google Groups "Puppet Users" group. To post to this group, send email to puppet-us...@googlegroups.com. To un

Re: [Puppet Users] Documentation contribution opportunity - Please help!

2010-08-27 Thread Tony G.
I recall someone started a translation to Chinese, I'll be happy to help with Spanish, and I've seen some French speakers into the list that might be interested. Thanks. On Fri, Aug 27, 2010 at 5:39 PM, James Turnbull wrote: > Tony G. wrote: > > Is there any way to contribute translating the cur

Re: [Puppet Users] Documentation contribution opportunity - Please help!

2010-08-27 Thread James Turnbull
Tony G. wrote: > Is there any way to contribute translating the current docs into > different languages? > We'd love to see this. What languages did you have in mind? Regards James Turnbull -- Puppet Labs - http://www.puppetlabs.com C: 503-734-8571 -- You received this message because you

Re: [Puppet Users] Documentation contribution opportunity - Please help!

2010-08-27 Thread Tony G.
Is there any way to contribute translating the current docs into different languages? Thanks. On Fri, Aug 27, 2010 at 3:16 PM, James Turnbull wrote: > Rob McBroom wrote: > > > > Sounds like it's mostly taken care of. Is there any need for someone to > go through http://github.com/reductivelabs/p

Re: [Puppet Users] Documentation contribution opportunity - Please help!

2010-08-27 Thread James Turnbull
Rob McBroom wrote: > > Sounds like it's mostly taken care of. Is there any need for someone to go > through http://github.com/reductivelabs/puppet-docs ? > Totally! Any improvements or additions to that would be gratefully received. We'd also welcome people updating the existing Markdown refe

Re: [Puppet Users] Documentation contribution opportunity - Please help!

2010-08-27 Thread Rob McBroom
On Aug 27, 2010, at 2:53 PM, James Turnbull wrote: > Rob McBroom wrote: >> On Aug 27, 2010, at 2:11 PM, Brice Figureau wrote: >> >>> They're not real filenames just pointers to where the files are. >>> That means all files in: >>> lib/puppet/types/*.rb >>> lib/puppet/providers/*.rb > > That's my

Re: [Puppet Users] Documentation contribution opportunity - Please help!

2010-08-27 Thread Brice Figureau
On 27/08/10 20:44, Rob McBroom wrote: > On Aug 27, 2010, at 2:11 PM, Brice Figureau wrote: > >> They're not real filenames just pointers to where the files are. >> That means all files in: >> lib/puppet/types/*.rb >> lib/puppet/providers/*.rb > > I don't think you understand (or I don't). > >

Re: [Puppet Users] Documentation contribution opportunity - Please help!

2010-08-27 Thread James Turnbull
Rob McBroom wrote: > On Aug 27, 2010, at 2:11 PM, Brice Figureau wrote: > >> They're not real filenames just pointers to where the files are. >> That means all files in: >> lib/puppet/types/*.rb >> lib/puppet/providers/*.rb That's my typo - mea culpa: lib/puppet/type/*.rb lib/puppet/provider/*.r

RE: [Puppet Users] Documentation contribution opportunity - Please help!

2010-08-27 Thread Kinzel, David
>There are no directories named `types` or `providers`. > >There are no files anywhere in the entire repo named >`typename.rb` or `functioname.rb`. > Perhaps he means types as in these: lib/puppet/type/*.rb? Same goes for providers. This email communication and any files transmitted with it may

Re: [Puppet Users] Documentation contribution opportunity - Please help!

2010-08-27 Thread Rob McBroom
On Aug 27, 2010, at 2:11 PM, Brice Figureau wrote: > They're not real filenames just pointers to where the files are. > That means all files in: > lib/puppet/types/*.rb > lib/puppet/providers/*.rb I don't think you understand (or I don't). % ls lib/puppet/types/*.rb ls: No match. % l

Re: [Puppet Users] Documentation contribution opportunity - Please help!

2010-08-27 Thread Brice Figureau
On 27/08/10 19:16, Rob McBroom wrote: > On Aug 27, 2010, at 12:03 PM, Brice Figureau wrote: > >> Yes, the documentation is embedded in the source code. >> You need to patch this part of the code. > > That's what I thought, but where are the files James mentions? I don't see > `lib/puppet/types`,

Re: [Puppet Users] Documentation contribution opportunity - Please help!

2010-08-27 Thread Rob McBroom
On Aug 27, 2010, at 12:03 PM, Brice Figureau wrote: > Yes, the documentation is embedded in the source code. > You need to patch this part of the code. That's what I thought, but where are the files James mentions? I don't see `lib/puppet/types`, `lib/puppet/providers`, `functioname.rb`, etc. in

Re: [Puppet Users] Documentation contribution opportunity - Please help!

2010-08-27 Thread Brice Figureau
On Fri, 2010-08-27 at 10:29 -0400, Rob McBroom wrote: > On Aug 10, 2010, at 10:53 PM, James Turnbull wrote: > > > 1. The types and providers documentation (lib/puppet/types/typename.rb & > > lib/puppet/providers/provider...) > > 2. The functions and metaparameter documentation > > (lib/puppet/pars

Re: [Puppet Users] Documentation contribution opportunity - Please help!

2010-08-27 Thread Rob McBroom
On Aug 10, 2010, at 10:53 PM, James Turnbull wrote: > 1. The types and providers documentation (lib/puppet/types/typename.rb & > lib/puppet/providers/provider...) > 2. The functions and metaparameter documentation > (lib/puppet/parser/functions/functioname.rb) > 3. The configuration reference (lib

Re: [Puppet Users] Documentation contribution opportunity - Please help!

2010-08-12 Thread Rob McBroom
On Aug 12, 2010, at 3:29 PM, James Turnbull wrote: 1) It looks like text enclosed `like this` is properly converted to like this on the back-end, but there’s no styling to set this text apart. (It should show up in a fixed-width font at the very least). >>> I've updated the style

Re: [Puppet Users] Documentation contribution opportunity - Please help!

2010-08-12 Thread James Turnbull
Rob McBroom wrote: > On Aug 11, 2010, at 4:48 PM, James Turnbull wrote: > >> Rob McBroom wrote: >>> 1) It looks like text enclosed `like this` is properly converted to >>> like this on the back-end, but there’s no styling to set this >>> text apart. (It should show up in a fixed-width font at th

Re: [Puppet Users] Documentation contribution opportunity - Please help!

2010-08-12 Thread Rob McBroom
On Aug 11, 2010, at 4:48 PM, James Turnbull wrote: > Rob McBroom wrote: >> 1) It looks like text enclosed `like this` is properly converted to >> like this on the back-end, but there’s no styling to set this >> text apart. (It should show up in a fixed-width font at the very least). > > I've up

Re: [Puppet Users] Documentation contribution opportunity - Please help!

2010-08-11 Thread James Turnbull
Rob McBroom wrote: > 1) It looks like text enclosed `like this` is properly converted to > like this on the back-end, but there’s no styling to set this > text apart. (It should show up in a fixed-width font at the very least). I've updated the style and pushed an update. > 2) There are places

Re: [Puppet Users] Documentation contribution opportunity - Please help!

2010-08-11 Thread James Turnbull
Rob McBroom wrote: > > Like I said, no time at the moment, but if I were to fork that repo, I could > just send a pull request, right? > > [1]: http://docs.puppetlabs.com/references/latest/configuration.html Correct. Thanks James Turnbull -- Puppet Labs - http://www.puppetlabs.com C: 503-73

Re: [Puppet Users] Documentation contribution opportunity - Please help!

2010-08-11 Thread Rob McBroom
On Aug 11, 2010, at 11:00 AM, James Turnbull wrote: > Okay - I will fix that one. Thanks. >> puppet --configprint templatedir >> > > Thanks - fixed that one - any others? None that I’ve personally run across, but cloning `puppet-docs` and searching for the regex '--\w' shows a few. There are

Re: [Puppet Users] Documentation contribution opportunity - Please help!

2010-08-11 Thread James Turnbull
Rob McBroom wrote: > I’ve noticed a couple of things related to in-line fixed-width text > (or whatever you want to call the expected result of using back ticks > in Markdown). > > 1) It looks like text enclosed `like this` is properly converted to > like this on the back-end, but there’s no styli

Re: [Puppet Users] Documentation contribution opportunity - Please help!

2010-08-11 Thread Rob McBroom
On Aug 10, 2010, at 10:53 PM, James Turnbull wrote: > During this process we began doing a programmatic conversion of the > Restructured Text output from the automatically generated documentation > to Markdown.The conversion process is less than perfect and some of > the Markdown generated is

[Puppet Users] Documentation contribution opportunity - Please help!

2010-08-10 Thread James Turnbull
Hi all One of the big pieces of work we undertook earlier in the year was migrating the wiki from Trac and establishing the Puppet Docs site at: http://docs.puppetlabs.com During this process we began doing a programmatic conversion of the Restructured Text output from the automatically generate