]> git.cworth.org Git - notmuch-wiki/blobdiff - index.mdwn
index: move development and contributing towards the end
[notmuch-wiki] / index.mdwn
index 4235c6146f98c2ccf8ed61b72c83a0994a5d177b..674a835a4b655d7c3628cbfac191f89dfe62ef43 100644 (file)
@@ -16,6 +16,8 @@ email, but don't want to give a 3rd-party access to your email...
 
 Then notmuch may be exactly what you've been looking for.
 
+[[!toc levels=2]]
+
 ## Why is it named Notmuch?
 
 * "Not much mail" is what Notmuch thinks about your email
@@ -60,6 +62,16 @@ the location of your mail store and how to start the initial indexing.
 For a little more detailed guide, see [[Getting Started with
 Notmuch|getting-started]].
 
+## Email Clients and Front Ends
+
+Notmuch ships with a powerful set of [[command-line tools|manpages]], an
+[[email client for Emacs|notmuch-emacs]], another
+[client for vim](http://git.notmuchmail.org/git/notmuch/blob/HEAD:/vim/README),
+and a [[Mutt integration script|notmuch-mutt]].
+
+There are also many other [[email clients and frontends|frontends]] based on
+Notmuch.
+
 ## Documentation
 
   * [[Notmuch manual pages|manpages]]
@@ -68,8 +80,8 @@ Notmuch|getting-started]].
   * [[Searching]]
   * [[Excluding and deleting messages|excluding]]
   * [[Initial tagging|Initial_Tagging]]
-  * [[Tips for using notmuch within Emacs|emacstips]]
-  * [[Remote usage|remoteusage]]
+  * Tips for using Notmuch with [[Emacs|emacstips]], [[Vim|vimtips]], and [[Mutt|mutttips]]
+  * [[Emacs remote usage|remoteusage]]
   * [[Performance|performance]]
   * [[References|references]]
   * [[Notmuch Library Language Bindings|bindings]]
@@ -77,16 +89,6 @@ Notmuch|getting-started]].
 Apart from the wiki, help is available via email and on IRC (see
 below).  Join the mailing list.  Read the archives.  Ask questions.
 
-## Email clients and front ends
-
-Notmuch ships with a powerful set of [[command-line tools|manpages]], an
-[[email client for Emacs|notmuch-emacs]], another
-[client for vim](http://git.notmuchmail.org/git/notmuch/blob/HEAD:/vim/README),
-and a [[Mutt integration script|notmuch-mutt]].
-
-There are also many other [[email clients and frontends|frontends]] based on
-Notmuch. And a few tips about integrating it with [[Mutt|mutttips]] and [[Vim|vimtips]].
-
 ## Screenshots
 
 * [[Emacs UI screenshots|screenshots]]
@@ -109,40 +111,10 @@ distributions:
 * [Slackware](http://slackbuilds.org/repository/13.37/office/notmuch/)
 * [Ubuntu](http://packages.ubuntu.com/search?keywords=notmuch)
 
-## Development and Contributing
-
-All of the code for Notmuch is available as [free
-software](http://www.fsf.org/licensing/essays/free-sw.html) released
-under the GNU [GPL version
-3](http://www.fsf.org/licensing/licenses/gpl.html). The latest
-versions can be checked out via git with this command:
-
-        git clone git://notmuchmail.org/git/notmuch
-
-You can browse the
-[Notmuch code history online](http://git.notmuchmail.org/git/notmuch). And
-finally, you can
-[subscribe to the `notmuch-commits` list](http://notmuchmail.org/mailman/listinfo/notmuch-commits)
-to watch every commit made to notmuch and the notmuchmail.org web
-site.
-
-We have a [buildbot](http://buildbot.notmuchmail.org/grid) (here's
-its
-[configuration](https://github.com/tomprince/buildbot-configs/tree/notmuch)).
-
-Contributions, such as patches, to Notmuch are most welcome. Please refer to the
-[[guide to contributing|contributing]].
-
-## Troubleshooting and reporting bugs
-
-For hints about troubleshooting and bug reporting see [[bugs]].
-
-For a list of known bugs see the [[nmbug status page|http://nmbug.notmuchmail.org/status/#Bugs]].
-
 ## Contact: Email & IRC
 
 Comments? Please feel free to email the notmuch mailing list:
-notmuch@notmuchmail.org (subscription is not required, but you can
+<mailto:notmuch@notmuchmail.org> (subscription is not required, but you can
 also subscribe to the
 [notmuch mailing list](http://notmuchmail.org/mailman/listinfo/notmuch)). You
 can also browse the
@@ -161,12 +133,42 @@ If you prefer real-time chat, there is often someone on the
 ask if you can ask a question, just ask, and please wait for an answer, we might
 not be in your timezone.
 
-## Feature ideas
+## Troubleshooting, Reporting Bugs and Feature Requests
+
+Please send bug reports and feature requests to the [Notmuch mailing
+list](http://notmuchmail.org/mailman/listinfo/notmuch)
+<mailto:notmuch@notmuchmail.org>.
+
+For hints about troubleshooting and bug reporting see [[bugs]].
+
+Please see the [nmbug status page](http://nmbug.notmuchmail.org/status/) for
+lists of [known bugs](http://nmbug.notmuchmail.org/status/#Bugs) and [feature
+requests](http://nmbug.notmuchmail.org/status/#Wish-list).
+
+## Development and Contributing
+
+All of the code for Notmuch is available as [free
+software](http://www.fsf.org/licensing/essays/free-sw.html) released
+under the GNU [GPL version
+3](http://www.fsf.org/licensing/licenses/gpl.html). The latest
+versions can be checked out via git with this command:
+
+        git clone git://notmuchmail.org/git/notmuch
 
-If you have a feature idea/request, please send it to the
-[mailing list](http://notmuchmail.org/mailman/listinfo/notmuch). You
-don't have to be subscribed to send, although there might be a delay
-for non-subscribers.
+You can browse the [Notmuch code history
+online](http://git.notmuchmail.org/git/notmuch). A notification is sent to the
+[notmuch-commits mailing
+list](http://notmuchmail.org/mailman/listinfo/notmuch-commits) for every commit
+made to Notmuch and the notmuchmail.org web site. [The Notmuch OpenHub project
+page](https://www.openhub.net/p/notmuch) has a nice summary of the codebase and
+activity.
+
+We have a [buildbot](http://buildbot.notmuchmail.org/grid) (here's
+its
+[configuration](https://github.com/tomprince/buildbot-configs/tree/notmuch)).
+
+Contributions, such as patches, to Notmuch are most welcome. Please refer to the
+[[guide to contributing|contributing]].
 
 ## Website