docs: Make it more clear what each part of core does right away

adamcik · adamcik · commit 907f920f1824 · 2015-04-24T00:13:30.000+02:00
diff --git a/docs/api/core.rst b/docs/api/core.rst
@@ -14,38 +14,44 @@ as a Pykka actor.
 
 .. autoclass:: mopidy.core.Core
 
-  .. automethod:: get_uri_schemes
+  .. attribute:: tracklist
 
-  .. automethod:: get_version
+    Manages everything related to the list of tracks we will play.
+    See :class:`~mopidy.core.TracklistController`.
+
+  .. attribute:: playback
+
+    Manages playback state and the current playing track.
+    See :class:`~mopidy.core.PlaybackController`.
 
-  .. autoattribute:: tracklist
-    :annotation:
+  .. attribute:: library
 
-  .. autoattribute:: playback
-    :annotation:
+    Manages the music library, e.g. searching and browsing for music.
+    See :class:`~mopidy.core.LibraryController`.
 
-  .. autoattribute:: library
-    :annotation:
+  .. attribute:: playlists
 
-  .. autoattribute:: playlists
-    :annotation:
+    Manages stored playlists. See :class:`~mopidy.core.PlaylistsController`.
 
-  .. autoattribute:: mixer
-    :annotation:
+  .. attribute:: mixer
 
-  .. autoattribute:: history
-    :annotation:
+    Manages volume and muting. See :class:`~mopidy.core.MixerController`.
+
+  .. attribute:: history
+
+    Keeps record of what tracks have been played.
+    See :class:`~mopidy.core.HistoryController`.
+
+  .. automethod:: get_uri_schemes
+
+  .. automethod:: get_version
 
 
 Tracklist controller
 ====================
 
 .. autoclass:: mopidy.core.TracklistController
 
-Manages everything related to the tracks we are currently playing. This is
-likely where you need to start as only tracks that are in the *tracklist* can be
-played.
-
 Manipulating
 ------------
 
@@ -107,35 +113,27 @@ seek, and volume control.
 History controller
 ==================
 
-Keeps record of what tracks have been played.
-
 .. autoclass:: mopidy.core.HistoryController
     :members:
 
 
 Playlists controller
 ====================
 
-Manages persistence of playlists.
-
 .. autoclass:: mopidy.core.PlaylistsController
     :members:
 
 
 Library controller
 ==================
 
-Manages the music library, e.g. searching for tracks to be added to a playlist.
-
 .. autoclass:: mopidy.core.LibraryController
     :members:
 
 
 Mixer controller
 ================
 
-Manages volume and muting.
-
 .. autoclass:: mopidy.core.MixerController
     :members:
 
