guide/CONTRIBUTING.md
2014-12-20 19:31:57 -05:00

3.4 KiB

Contributions Welcome!

The maintainers of this Copyleft Guide project encourage contribution from the community. Part of the impetus for this project was to create a community around a "copyleft codebase" for information about copyleft. In other words, this project is a tutorial project about Copyleft that is like a Free Software project.

Who Is In Charge?

Currently, Bradley M. Kuhn is the editor-in-chief of this Guide project. However, many other contributors have given patches and improvements to the text. Review the commit log in the Git repository for more details on who has contributed to the project.

How Do I Get Involved?

The Guide is maintained in a copylefted distributed version control system called Git. Currently, the project utilizes the services of a Git hosting website called Gitorious. (The software which runs Gitorious is, itself, copylefted, too.)

Those who are comfortable with Gitorious can submit merge requests on copyleft.org's gitorious site. See the section "Merge Request and Patch Workflow" below for more information on the details of doing that.

However, lack of Git and/or LaTeX knowledge is not a barrier for contribution to this project. Useful contributions will be accepted by the following means as well:

Please, do not worry if your patches or new sections of text are not properly formatted as patches and/or are not formatted in LaTeX properly. Indeed, feel free to offer patches that break LaTeX formatting, or to just write up your suggestion in an email. If the content is appropriate for the Guide, the editor-in-chief or someone else will format your contribution properly for LaTeX.

Note: by submitting contributions via any of these means, you agree to the "Author's Certificate of Origin" (see below).

How Do I Figure Out What To Contribute?

If you're looking for something to fix, just grep the *.tex files for "FIXME" and you'll find plenty. Many of them are simple and easy to do. Some of them are writing, and some of them are simply formatting-related.

If you want a larger, more involved writing project, take a look at the TODO list in this repository. That list has bigger items that other contributors have identified as necessary. (BTW, the project contributors are considering various possible copylefted bug-tracking solutions, but admittedly haven't picked a bug-tracker yet.)

There is also a TODO list on the website, which are mostly related to formatting, layout and infrastructure, but if you'd like to help there, such help is also welcome.

Merge Request and Patch Workflow

Currently, the main location for work on this project is Gitorious, and active new development on the project happens on the 'next' branch. Here is a suggested workflow for submitting patches — first doing so with the Gitorious infrastructure and second avoiding the Gitorious infrastructure.