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