Update AUTHORS file

3 files changed, 42 insertions, 28 deletions

diff --git a/AUTHORS b/AUTHORS
index 2261f24..396fc29 100644
--- a/AUTHORS
+++ b/AUTHORS
@@ -1,10 +1,14 @@
+Authors
+=======
+
 Contributors
-~~~~~~~~~~~~
-Aleksey Lim <alsroot@member.fsf.org>
+------------
+Aleksey Lim <alsroot@sugarlabs.org>
+Daniel Narvaez <dwnarvaez@gmail.com>
 Guillaume Dorchies <guillaume.dorchies@gmail.com>
 Tal Shalif <tal+sugarlabs.org@shalif.com>
 Yaakov Selkowitz <yselkowitz@users.sourceforge.net>
 
 Maintainers
-~~~~~~~~~~~
-Aleksey Lim <alsroot@member.fsf.org>
+-----------
+Aleksey Lim <alsroot@sugarlabs.org>
diff --git a/HACKING b/HACKING
index a9b5e5b..cab54f8 100644
--- a/HACKING
+++ b/HACKING
@@ -1,15 +1,29 @@
-Before committing
-~~~~~~~~~~~~~~~~~
-All source files need to be passed through indent command.
-Follow http://wiki.sugarlabs.org/go/Activity_Team/Sugar_Lint instructions
-and especially "Lint files before committing" section.
-Otherwise just call indent command with settings [1].
+How to contribute
+=================
+
+Useful notes how to contribute to the project.
 
+Before committing
+-----------------
+All source files need to be passed through `sugar-lint`_ command.
+Follow sugar-lint home page instructions and especially
+`"Lint files before committing"` section.
 
 Send patches
-~~~~~~~~~~~~
-Create your patches using "git format" command and send them to all maintainers
-from AUTHORS file. The easiest way it just using "git send-email" command.
+------------
+Create your patches using ``git format`` command and send them to all
+maintainers from the :doc:`AUTHORS <AUTHORS>` file with CCing to
+sugar-network@googlegroups.com. The easiest way is using ``git send-email``
+command.
+
+Gitorious forks
+---------------
+Another useful way to contribute, especially for big improvements, is creating
+Gitorious forks and request them for merge to the trunk.
 
+* http://blog.gitorious.org/2009/05/09/weve-made-a-few-changes/
+  (see `"Merge requests"` topic)
+* http://blog.gitorious.org/2009/07/15/new-merge-request-functionality/
+* http://blog.gitorious.org/2009/11/06/awesome-code-review/
 
-[1] http://git.sugarlabs.org/projects/sugar-lint/repos/mainline/blobs/master/sugar/lint/indent.pro
+.. _sugar-lint: http://wiki.sugarlabs.org/go/Platform_Team/Sugar_Lint
diff --git a/README b/README
index 73804a3..f71bd95 100644
--- a/README
+++ b/README
@@ -1,19 +1,15 @@
-About
-~~~~~
-gstespeak is a src plugin to use espeak by way of sound source.
-
+Introduction
+============
 
-Home Page
-~~~~~~~~~
-http://wiki.sugarlabs.org/go/Activity_Team/gst-plugins-espeak
+gstespeak is a src plugin to use espeak by way of sound source.
+See `home page`_ for more details.
 
+Sources
+=======
 
-Contribution
-~~~~~~~~~~~~
-See HACKING file.
+Clone source repository from `Gitorious`_ project:
 
+    ``git clone git://git.sugarlabs.org/gst-plugins-espeak/mainline.git``
 
-Get it
-~~~~~~
-http://git.sugarlabs.org/projects/gst-plugins-espeak
-http://download.sugarlabs.org/sources/honey/gst-plugins-espeak/
+.. _home page: http://wiki.sugarlabs.org/go/Activity_Team/gst-plugins-espeak
+.. _Gitorious: http://git.sugarlabs.org/gst-plugins-espeak