Fixup reStructuredText in README.
[hooke.git] / README
diff --git a/README b/README
index 3ab3fa93d852dd2b7284b4766043b75f9da17d73..22aea1758cc56bd3f6a6315c3a6f90a3ed7bcbd5 100644 (file)
--- a/README
+++ b/README
@@ -8,6 +8,7 @@ requires the analysis of thousands of force curves at a time. As of
 today, there is no standard, free software for the analysis of force
 curves. Hooke aims to solve that.
 
+
 What it does?
 =============
 
@@ -18,8 +19,19 @@ What it does?
   * Handles force-clamp force experiments (experimental)
   * It is extensible by users by mean of plugins and drivers
 
-See the Google Code website for more details
-  http://code.google.com/p/hooke/
+See `Hooke's Google Code homepage`_ for more details.
+
+.. _Hooke's Google Code homepage: http://code.google.com/p/hooke/
+
+
+How do you make it work?
+========================
+
+See the doc/tutorial.txt file distributed with hooke, or the `online
+docs`_.
+
+.. _online docs: http://www.physics.drexel.edu/~wking/rsrch/hooke/
+
 
 Is this published in some peer-reviewed journal?
 ================================================
@@ -31,13 +43,21 @@ doi:10.1093/bioinformatics/btp180
 
 Please cite Hooke if you use it.
 
+
 Troubleshooting
 ===============
 
 If you have troubles in using it, before throwing it in the trash:
-  1) try look at the TroubleShooting page or in the discussion group
-  2) ask a question in the discussion group!
-http://groups.google.com/group/hookesoftware
+
+1. Search the `issue tracker
+   <http://code.google.com/p/hooke/issues/list>`_.
+2. Look at the `troubleshooting wiki page
+   <http://code.google.com/p/hooke/wiki/TroubleShooting>`_.
+3. Search the `discussion group
+   <http://groups.google.com/group/hookesoftware>`_.
+4. Ask a question in the discussion group.
+5. File a bug on the issue tracker.
+
 
 Disclaimer
 ==========
@@ -45,5 +65,13 @@ Disclaimer
 Remember that Hooke is still experimental software! It has been mostly
 done to fit the needs of its authors, and there is no guarantee it
 will do what you need. However, you can write us/help us improve it so
-that it does. We aim to make of Hooke a little, universal tool that
-can help your research.
+that it does. We aim to make of Hooke a robust tool that can help your
+research.
+
+
+Licensing
+=========
+
+Hooke is released under the GNU Lesser General Public License, either
+version 3 of the License (COPYING and COPYING.LESSER), or (at your
+option) any later version.