What is the best way to contribute to docs.opscode.com?


#1

Hey everyone,

Is it possible for outsiders to contribute to docs.opscode.com? Today I got
bit by a small discrepancy in the bluepill documentation on there (on the lwrp
page http://docs.opscode.com/lwrp_bluepill.html).

The community page and the readme on GitHub both give the example where the
template call (template “/etc/bluepill/my_app.pill”) includes the ".pill"
extension, whereas the page on docs doesn’t include the extension.

Since I was working off the docs page (and since I’m new to bluepill), I
was calling template “/etc/bluepill/my_app”, as the docs site
suggests. However I was getting an error* that bluepill triggers when a
configuration file is missing. This tripped me up for a while, since I
could clearly see that the file “/etc/bluepill/my_app” was present :slight_smile:

So what’s the accepted practice to contribute to the docs site? Open a
ticket on tickets.opscode.com? Or is there a way to contribute directly,
like on a wiki?

Thanks in advance,

Mat

  • The error: Unknown command my_app (or application my_app has not been
    loaded yet)

#2

File a ticket, make a pull request https://github.com/opscode/chef-docs :slight_smile:

Make sure you have a CLA on file, I presume.

–Noah

On Dec 10, 2012, at 8:29 PM, Mathieu Martin wrote:

Hey everyone,

Is it possible for outsiders to contribute to docs.opscode.com? Today I got bit by a small discrepancy in the bluepill documentation on there (on the lwrp page).

The community page and the readme on GitHub both give the example where the template call (template “/etc/bluepill/my_app.pill”) includes the “.pill” extension, whereas the page on docs doesn’t include the extension.

Since I was working off the docs page (and since I’m new to bluepill), I was calling template “/etc/bluepill/my_app”, as the docs site suggests. However I was getting an error* that bluepill triggers when a configuration file is missing. This tripped me up for a while, since I could clearly see that the file “/etc/bluepill/my_app” was present :slight_smile:

So what’s the accepted practice to contribute to the docs site? Open a ticket on tickets.opscode.com? Or is there a way to contribute directly, like on a wiki?

Thanks in advance,

Mat

  • The error: Unknown command my_app (or application my_app has not been loaded yet)

#3

Github.com/opscode/chef-docshttp://Github.com/opscode/chef-docs is the repo. Just submit a pull request.

Thanks!

Nathen Harvey

On Dec 10, 2012, at 11:30 PM, “Mathieu Martin” <webmat@gmail.commailto:webmat@gmail.com> wrote:

Hey everyone,

Is it possible for outsiders to contribute to docs.opscode.comhttp://docs.opscode.com? Today I got bit by a small discrepancy in the bluepill documentation on there (on the lwrp pagehttp://docs.opscode.com/lwrp_bluepill.html).

The community page and the readme on GitHub both give the example where the template call (template “/etc/bluepill/my_app.pill”) includes the “.pill” extension, whereas the page on docs doesn’t include the extension.

Since I was working off the docs page (and since I’m new to bluepill), I was calling template “/etc/bluepill/my_app”, as the docs site suggests. However I was getting an error* that bluepill triggers when a configuration file is missing. This tripped me up for a while, since I could clearly see that the file “/etc/bluepill/my_app” was present :slight_smile:

So what’s the accepted practice to contribute to the docs site? Open a ticket on tickets.opscode.comhttp://tickets.opscode.com? Or is there a way to contribute directly, like on a wiki?

Thanks in advance,

Mat

  • The error: Unknown command my_app (or application my_app has not been loaded yet)

#4

No CLA required, per guidelines:

On Mon, Dec 10, 2012 at 11:32 PM, Noah Kantrowitz noah@coderanger.net wrote:

File a ticket, make a pull request https://github.com/opscode/chef-docs :slight_smile:

Make sure you have a CLA on file, I presume.

–Noah

On Dec 10, 2012, at 8:29 PM, Mathieu Martin wrote:

Hey everyone,

Is it possible for outsiders to contribute to docs.opscode.com? Today I got bit by a small discrepancy in the bluepill documentation on there (on the lwrp page).

The community page and the readme on GitHub both give the example where the template call (template “/etc/bluepill/my_app.pill”) includes the “.pill” extension, whereas the page on docs doesn’t include the extension.

Since I was working off the docs page (and since I’m new to bluepill), I was calling template “/etc/bluepill/my_app”, as the docs site suggests. However I was getting an error* that bluepill triggers when a configuration file is missing. This tripped me up for a while, since I could clearly see that the file “/etc/bluepill/my_app” was present :slight_smile:

So what’s the accepted practice to contribute to the docs site? Open a ticket on tickets.opscode.com? Or is there a way to contribute directly, like on a wiki?

Thanks in advance,

Mat

  • The error: Unknown command my_app (or application my_app has not been loaded yet)

#5

Ah! Awesome, thanks everyone :slight_smile:

Mat

On Monday, December 10, 2012, Mike wrote:

No CLA required, per guidelines:
https://github.com/opscode/chef-docs/blob/master/CONTRIBUTING

On Mon, Dec 10, 2012 at 11:32 PM, Noah Kantrowitz <noah@coderanger.net<javascript:;>>
wrote:

File a ticket, make a pull request https://github.com/opscode/chef-docs:-)

Make sure you have a CLA on file, I presume.

–Noah

On Dec 10, 2012, at 8:29 PM, Mathieu Martin wrote:

Hey everyone,

Is it possible for outsiders to contribute to docs.opscode.com? Today
I got bit by a small discrepancy in the bluepill documentation on there (on
the lwrp page).

The community page and the readme on GitHub both give the example where
the template call (template “/etc/bluepill/my_app.pill”) includes the
".pill" extension, whereas the page on docs doesn’t include the extension.

Since I was working off the docs page (and since I’m new to bluepill),
I was calling template “/etc/bluepill/my_app”, as the docs site suggests.
However I was getting an error* that bluepill triggers when a configuration
file is missing. This tripped me up for a while, since I could clearly see
that the file “/etc/bluepill/my_app” was present :slight_smile:

So what’s the accepted practice to contribute to the docs site? Open a
ticket on tickets.opscode.com? Or is there a way to contribute directly,
like on a wiki?

Thanks in advance,

Mat

  • The error: Unknown command my_app (or application my_app has not
    been loaded yet)


Sent from my rotary phone 5