diff get-involved.md @ 80:05b2f0d66aa8 kai

Some website authoring. Should be completed right now.
author Kai T. Ohlhus <k.ohlhus@gmail.com>
date Fri, 14 Oct 2016 03:15:09 +0200
parents 8224b565e6fd
children 5caa2af27956
line wrap: on
line diff
--- a/get-involved.md	Thu Oct 13 17:55:37 2016 +0200
+++ b/get-involved.md	Fri Oct 14 03:15:09 2016 +0200
@@ -4,10 +4,9 @@
 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,
-helping to improve the web pages.
+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
@@ -15,59 +14,51 @@
 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
-<a href="http://www.octave.org/wiki/Projects">list of possible projects</a>
+For some inspiration, we do maintain a [list of possible projects][1]
 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.
+[`maintainers@octave.org`][2] mailing list or the IRC [`#octave` channel][3]
+in Freenode and discuss your ideas there.  That way others can provide input
+early on, which makes your contribution more likely to get accepted.
+
+<p>
+<div class="alert">
+{% octicon stop class:"octicon-stop-octave" %}
+Please do <strong>not</strong> send help requests or bug reports to the
+<samp>maintainers@octave.org</samp> mailing list.  Refer to the
+<a href="{{ "bugs.html" | relative_url }}">bug tracker</a> or other
+<a href="{{ "support.html" | relative_url }}">support options</a> instead.
+</div>
+</p>
+
+[1]: http://www.octave.org/wiki/Projects
+[2]: https://lists.gnu.org/mailman/listinfo/octave-maintainers
+[3]: http://webchat.freenode.net/?channels=octave&amp;uio=MT1mYWxzZSYyPXRydWUmMTI9dHJ1ZQda
 
 
-## Contacting developers
-
-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 <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
-<a href="http://www.selenic.com/mercurial/wiki">Mercurial</a> (hg)
-archive.
+[Mercurial][4] (hg) archive.
 
-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>.
+The primary archive address is [http://www.octave.org/hg/octave][5],
+which currently redirects to [http://hg.savannah.gnu.org/hgweb/octave][6].
 
-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.
+If you decide to use the development sources from the Mercurial archive,
+please read the file [`etc/HACKING`][7] 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 <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
+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
 
 {% highlight text %}
 hg -v pull
@@ -76,16 +67,21 @@
 
 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>.
+information about [contributing to Octave's development][8].
+
+[4]: http://www.selenic.com/mercurial/wiki
+[5]: http://www.octave.org/hg/octave
+[6]: http://hg.savannah.gnu.org/hgweb/octave
+[7]: http://www.octave.org/hg/octave/file/tip/etc/HACKING
+[8]: {{ site.docs_url }}/Contributing-Guidelines.html#Contributing-Guidelines
 
 
-## Octave Forge
+# Octave Forge
 
-The community-developed [Octave-Forge][forge] packages expand Octave's core
+The community-developed [Octave-Forge][9] packages expand Octave's core
 functionality by providing field specific features via Octave's package system.
 For example, image and signal processing, fuzzy logic, instrument control,
-and statistics packages are examples of individual Octave-Forge packages.
+and statistics packages are examples of individual [Octave-Forge packages][10].
 
-[forge]: http://octave.sourceforge.net/
-[forge-packages]: http://octave.sourceforge.net/packages.php
+[9]: http://octave.sourceforge.net/
+[10]: http://octave.sourceforge.net/packages.php