doc: Minor content changes

[mpd-sima.git] / doc / source / index.rst

diff --git a/doc/source/index.rst b/doc/source/index.rst
index fb96b7c2ce073babb0a7f2677a081e279a3aa089..3a1cb25f3701477d67d7eeffdde4143a82974850 100644 (file)
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -3,30 +3,65 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-MPD_sima's documentation!
-=========================
+#########################
+MPD_sima's documentation
+#########################
 
+MPD_sima is meant to **auto-magically queue** tracks in MPD_, it is a non interactive client for MPD_.
 
-Development documentation
--------------------------
+Actually there is no magic involved, it relies on music metadata found in music
+files tags and external information providers such as last.fm_. Then to use
+MPD_sima (or any advanced music players, MPD_ among them), you need to ensure
+your library is correctly tagged (see :ref:`metadata-convention`).
+
+The default setting for MPD_sima is to queue similar artists thanks to last.fm_
+suggestions but there are other possibilities.
+
+**To queue tracks from similar artists, start playing a track in MPD then launch MPD_sima:**
+
+.. code-block:: sh
 
-Contents:
+    # runs against localhost MPD (or whatever is set in MPD_HOST/MPD_PORT)
+    mpd-sima
+
+    # runs against a specific MPD server
+    mpd-sima --host mpd.example.org
+
+#####################
+User's documentation
+#####################
 
 .. toctree::
    :maxdepth: 2
+   :glob:
 
-   meta
-   lastfm
-   echonest
-   cache
+   user/*
 
 
+##########################
+Development documentation
+##########################
 
+.. toctree::
+   :maxdepth: 2
+   :titlesonly:
+
+   dev/mpdclient
+   dev/meta
+   dev/lastfm
+   dev/cache
+   dev/simadb
 
+
+###################
 Indices and tables
-==================
+###################
 
 * :ref:`genindex`
 * :ref:`modindex`
 * :ref:`search`
 
+
+.. include:: links.rst
+
+.. vim: spell spelllang=en