Mercurial > web-octave
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&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