contribute_guide.html

<!DOCTYPE html>
<html lang='en'>
  <head>
    <meta charset='utf-8'>
    <title>
      How to learn Emacs :: Contributing to this guide
    </title>
    <link href='emacs.css' media='all' rel='stylesheet'>
  </head>
  <body>
    <div id='sidebar'>
      <div id='info'>
        <h1>How to learn Emacs</h1>
        <p>By <a href="http://david.rothlis.net">David Röthlisberger</a>.<br/>
        Comments welcome at <a href="&#x6d;&#x61;&#x69;&#108;&#x74;&#x6f;&#x3a;&#100;&#97;&#118;&#105;&#x64;&#64;&#x72;&#x6f;&#116;&#x68;&#x6c;&#105;&#115;&#46;&#110;&#x65;&#x74;?subject=How%20to%20learn%20Emacs">&#100;&#97;&#x76;&#x69;&#x64;&#64;&#114;&#111;&#x74;&#x68;&#x6c;&#x69;&#x73;&#46;&#x6e;&#x65;&#x74;</a>.<br/>
        Last updated 8 Apr 2012.</p>
      </div>
      <div id='toc'>
        <!-- Table of Contents -->
<ul>
  <li><a href='howtolearn.html'>1. About this guide to Emacs</a></li>
  <li><a href='why.html'>2. Why Emacs</a></li>
</ul>
<p>—Basic usage—</p>
<ul>
  <li><a href='install.html'>3. Install the right Emacs</a></li>
  <li><a href='tutorial.html'>4. The very basics</a></li>
  <li><a href='basic_c.html'>5. Basic Unix/C workflow</a></li>
</ul>
<p>—Basic customisation—</p>
<ul>
  <li><a href='customize_c.html'>6. cc-mode customization</a></li>
  <li><a href='customize_colors.html'>7. Fix that awful color scheme</a></li>
  <li><a href='customize_general.html'>8. General customization</a></li>
</ul>
<p>—Miscellaneous—</p>
<ul>
  <li><a href='info.html'>9. Info documentation</a></li>
  <li><a href='contribute_emacs.html'>10. Contributing to Emacs</a></li>
</ul>
<p>—Appendices—</p>
<ul>
  <li><a href='ergonomics.html'>A. Ergonomics</a></li>
  <li><a href='osx.html'>B. OS X</a></li>
  <li class='current'>C. Contributing to this guide</li>
  <li><a href='glossary.html'>D. Glossary</a></li>
</ul>
      </div>
      <p>Copyright © 2012 <a href="http://david.rothlis.net">David Röthlisberger</a>.<br/>
      This guide is released under the<br/>
      <a rel="license" href="http://www.gnu.org/copyleft/fdl.html">GNU
      Free Documentation License</a>.</p>
    </div>
    <div id='content2'>
      <!-- Contents -->
<h1>Contributing to this guide</h1>
<p>This guide is released under the <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>. The source documents are available on
<a href="https://github.com/drothlis/how-to-learn-emacs">github</a>. Please contribute
patches, no matter how small, to correct errors or omissions. It&rsquo;s very easy!</p>

<p>I initially intended to write multiple variants of the introductory chapter
<a href="basic_c.html">&ldquo;Basic Unix/C workflow&rdquo;</a>: One targeting Ruby/Rails developers,
etc. I gave up due to a lack of time, but if you&rsquo;d like to contribute such a
chapter, please do. It could be tricky because I introduce concepts in a
particular order, and an introductory chapter for (say) Rails development would
require installing third-party packages, something I don&rsquo;t touch on until much
later.</p>
<h2>Super-easy way to contribute small patches</h2>
<p>If you have a small correction to wording or spelling, you can browse to the
source file on <a href="https://github.com/drothlis/how-to-learn-emacs">github</a>, click
the button that says &ldquo;Fork and edit this file&rdquo;, make your change, and submit a
&ldquo;pull request&rdquo;. This will require you to create a (free) account on github, but
you don&rsquo;t even need to checkout the source files onto your computer.</p>

<p>Or just <a href="mailto:david@rothlis.net?subject=How%20to%20learn%20Emacs">email me</a>
the correction. Unless you ask me otherwise, I will use your name and email
address in the change logs, which will be visible to anyone who downloads the
source repository from github.</p>
<h2>More complex changes</h2>
<p>See the <a href="https://github.com/drothlis/how-to-learn-emacs/blob/master/README">README</a> for
instructions on generating the html from the source haml files.</p>
      <!-- Contents -->
      <p class='next'><a rel='next' href='glossary.html'>Next: Glossary</a></p>
    </div>
  </body>
</html>