Skip to content

Commit

Permalink
Add section for documentation contributions (#1205)
Browse files Browse the repository at this point in the history
Hopefully this will lower the hurdle for people to submit documentation contributions. I know from myself that I didn't submit various documentation improvements, because I didn't know git and thought it would be a much more involved process. 
Ideally there would be a separate documentation section, but submitting this under the development contribution page for now (as per discussion with @Confectrician in #1179 (comment)).
Note that I am addressing the issue of DCO failures wrt specifying the full name that I ran into myself in #1197 (comment). I found a good discussion of the issue at dcoapp/app#43.

Signed-off-by: Mark Theiding <mark.theiding@gmail.com>
  • Loading branch information
theiding authored Apr 28, 2020
1 parent ba21a0f commit fadc2d6
Showing 1 changed file with 19 additions and 0 deletions.
19 changes: 19 additions & 0 deletions developers/contributing.md
Original file line number Diff line number Diff line change
Expand Up @@ -103,6 +103,7 @@ or `Fixes #XXX`, which will automatically close the issue when merged.
openHAB maintainers use the [GitHub review feature](https://help.github.com/articles/about-pull-request-reviews/) to indicate acceptance.


<a id="sign-your-work"></a>
### Sign your Work

The sign-off is a simple line at the end of the explanation for the
Expand Down Expand Up @@ -184,6 +185,24 @@ Don't forget: being a maintainer is a time investment.
Make sure you will have time to make yourself available.
You don't have to be a maintainer to make a difference on the project!

### Contributing to the Documentation
Sharing your knowledge through documentation contributions is incredibly valuable for the community allowing everybody to benefit from your lessons learned.
If you are not yet ready to contribute code don't let that stop you from contributing to the documentation.
Documentation change requests are very easy.
No need to file an issue.
You don't even need to know Git.
* Create a GitHub account and configure your full name in your profile.
* Go to the documentation page that you want to update and click on "Edit this page on GitHub" at the bottom.
* GitHub will bring up a web editor where you can enter your desired changes.
* You can preview your changes under the "Preview changes" tab.
* Add a title and optional description for your proposed change at the bottom of the editor.
* The [sign off rules](#sign-your-work) described above do apply to documentation contributions as well.
Simply add an empty line and the sign off statement "Signed-off-by: Joe Smith <joe.smith@email.com>" at the end of your change description at the bottom of the editor.
Note that as per the rules you have to provide your full name in the sign off and that full name has to match the name you configured in your GitHub profile for the DCO check to succeed.
* Click the "Propose file change" button at the bottom of the editor.

If you prefer to use Git you can of course use the code contribution process for documentation contributions as well.

## Community Guidelines

We want to keep the openHAB community awesome, growing and collaborative. We
Expand Down

0 comments on commit fadc2d6

Please sign in to comment.