diff contribute.md @ 46:171ca967fcc9 kai

Start new development branch closer to the current website, but more lightweigt for further maintanence.
author Kai T. Ohlhus <k.ohlhus@gmail.com>
date Wed, 28 Sep 2016 02:08:11 +0200
parents a1cb50997055
children
line wrap: on
line diff
--- a/contribute.md	Mon Sep 26 17:56:49 2016 +0200
+++ b/contribute.md	Wed Sep 28 02:08:11 2016 +0200
@@ -1,83 +1,86 @@
 ---
-layout: page
+layout: default
 title: Contribute
-permalink: /contribute/
 menu: true
 ---
 
-We always need more help improving Octave
-and there are many ways you can contribute.
-You can help by fixing bugs, developing new features,
-answering questions on the mailing list or IRC channel,
+We always need more help improving Octave and there are many ways
+you can contribute.  You can help by fixing bugs, developing new
+features, answering questions on the mailing list or IRC channel,
 helping to improve the web pages.
 
 If you are wondering what to work on, we have a standard answer:
-what would you like to work on?
-We try not to tell contributors what to work on
-as most people do their best work
-when they are within their own field of interest.
-So, we would love your help,
+what would you like to work on?  We try not to tell contributors
+what to work on as most people do their best work when they are
+within their own field of interest.  So, we would love your help,
 but would also love for you to work on what you love.
 
-If you need some inspiration,
-we do maintain a list of possible projects on the
-[Wiki](http://www.octave.org/wiki/Projects).
+If you need some inspiration, we do maintain a
+<a href="http://www.octave.org/wiki/Projects">list of possible projects</a>
+on the Wiki.
 
-If you have an idea on what to contribute,
-then join the maintainers mailing list and discuss your ideas there.
-That way others can provide input early on,
-which makes your contribution more likely to get accepted.
+If you have an idea on what to contribute, then join the
+maintainers mailing list and discuss your ideas there.  That way
+others can provide input early on, which makes your contribution
+more likely to get accepted.
 
-### Contacting developers
+
+## Contacting developers
 
-If you want to participate in Octave development, you should join the
-[maintainers@octave.org](https://lists.gnu.org/mailman/listinfo/octave-maintainers)
-mailing list.
-Please use this list only if you are participating in Octave's development.
-If you are looking for help in using Octave, please use the
-[help@octave.org](https://lists.gnu.org/mailman/listinfo/help-octave)
-list instead, or check out other
-[support options]({{"/support-options/" | prepend: site.baseurl}}).
+If you want to participate in Octave development, you should join
+the <a href="https://lists.gnu.org/mailman/listinfo/octave-maintainers">
+<code>maintainers@octave.org</code></a> mailing list.  <b>Please
+use this list only if you are participating in Octave's
+development.</b>  If you are looking for help in using Octave,
+please use the <a href="https://lists.gnu.org/mailman/listinfo/help-octave"><code>help@octave.org</code></a>
+list instead, or check out other <a href="support.html">support
+options</a>.
 
-For sometimes faster communication,
-you can also chat in IRC in #octave in Freenode.
-Note, however, that the primary medium for development talk is the mailing list.
+For sometimes faster communication, you can also chat in IRC
+in <code>#octave</code> in Freenode. Note, however, that the primary
+medium for development talk is the mailing list.
+
 
-### Using the Development Sources
+## Using the Development Sources
 
-The latest development sources of Octave are also available via Mercurial (hg) archive.
+The latest development sources of Octave are also available via
+<a href="http://www.selenic.com/mercurial/wiki">Mercurial</a> (hg)
+archive.
 
-The primary archive address is
-[http://www.octave.org/hg/octave](http://www.octave.org/hg/octave),
-which currently redirects to
-[http://hg.savannah.gnu.org/hgweb/octave](http://hg.savannah.gnu.org/hgweb/octave).
+The primary archive address
+is <a href="http://www.octave.org/hg/octave">http://www.octave.org/hg/octave</a>,
+which currently redirects
+to <a href="http://hg.savannah.gnu.org/hgweb/octave">http://hg.savannah.gnu.org/hgweb/octave</a>.
 
-If you decide to use the development sources from the Mercurial archive,
-please read the file
-[etc/HACKING](http://www.octave.org/hg/octave/file/tip/etc/HACKING)
+If you decide to use the development sources from the Mercurial
+archive, please read the
+file <a href="http://www.octave.org/hg/octave/file/tip/etc/HACKING"><code>etc/HACKING</code></a>
 that is available with the source files.
 
-Assuming you have Mercurial and git installed on your machine you may obtain
-the latest development version of Octave sources with the following command:
+Assuming you have Mercurial and git installed on your machine you
+may obtain the latest development version of Octave sources with
+the following command:
 
 {% highlight text %}
 hg clone http://www.octave.org/hg/octave
 {% endhighlight %}
 
-This will clone two repositories,
-one of which is subrepository of the main Octave repository.
-Once you have these, you can resync with the archive by doing
+This will clone <em>two</em> repositories, one of which is
+subrepository of the main Octave repository. Once you have these,
+you can resync with the archive by doing
 
 {% highlight text %}
 hg -v pull
 hg -v update
 {% endhighlight %}
 
-The `-v` (verbose) option is not required but provides extra information
-about what was pulled and updated.
-The Octave manual has more information about contributing to Octave's development.
+The `-v` option is not required but provides extra information
+about what was pulled and updated.  The Octave manual has more
+information about <a href="doc/interpreter/Contributing-Guidelines.html#Contributing-Guidelines">contributing
+to Octave's development</a>.
 
-### Octave Forge
+
+## Octave Forge
 
 The community-developed [Octave-Forge][forge] packages expand Octave's core
 functionality by providing field specific features via Octave's package system.