Changeset - 57e8fa1cb2d7
[Not reviewed]
0 1 0
Bradley Kuhn (bkuhn) - 10 years ago 2014-12-21 00:31:57
bkuhn@ebb.org
Note merge request should usually target next.

Some targets to master are acceptable, though.
1 file changed with 11 insertions and 2 deletions:
0 comments (0 inline, 0 general)
CONTRIBUTING.md
Show inline comments
...
 
@@ -29,51 +29,60 @@ 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:
 

	
 
  * Patches posted to
 
    [the mailing list](http://lists.copyleft.org/cgi-bin/mailman/listinfo/discuss).
 

	
 
  * New sections of text or simply ideas and input emailed to
 
    [the mailing list](http://lists.copyleft.org/cgi-bin/mailman/listinfo/discuss).
 

	
 
  * Ideas and suggestions mentioned on the
 
    [irc channel #copyleft on freenode](irc://irc.freenode.net/#copyleft).
 

	
 
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](TODO.md).  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](https://copyleft.org/todo/), 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
 
[on Gitorious](https://gitorious.org/copyleft-org/tutorial), and active new
 
development on the project happens on the
 
['next' branch](https://gitorious.org/copyleft-org/tutorial/source/next:)
 
(which is
 
[auto-published on the copyleft.org/guide-next URL](https://copyleft.org/guide-next/)).
 
Here is a suggested workflow for submitting patches — first doing so
 
*with* the Gitorious infrastructure and second *avoiding* the Gitorious
 
infrastructure.
 
*with* the Gitorious infrastructure, second *avoiding* the Gitorious
 
infrastructure but still using Git, and third avoiding Git altogether.
 

	
 
Merge requests and/or patches against
 
['next' branch](https://gitorious.org/copyleft-org/tutorial/source/next:) are
 
typically much preferred, and the workflow explanations below assume that.
 
However, merge requests and/or patches against
 
['master' branch](https://gitorious.org/copyleft-org/tutorial/source/master:)
 
are not necessarily rejected.  In fact, if your change is a fix for typo,
 
spelling, grammar, formatting or anything urgent, submitting a patch against
 
'master' may make more sense.
 

	
0 comments (0 inline, 0 general)