Improve multisite documentation

nephila · Jun 16, 2016 · f6000ef · f6000ef
1 parent 300dceb
commit f6000ef
Showing 1 changed file with 14 additions and 5 deletions.
diff --git a/docs/features.rst b/docs/features.rst
@@ -37,14 +37,23 @@ Multisite
 
 django CMS blog provides full support for multisite setups.
 
+Basic multisite
+^^^^^^^^^^^^^^^
+
+To enabled basic multisite add ``BLOG_MULTISITE = True`` to the project settings.
+
 Each blog post can be assigned to none, one or more sites: if no site is selected, then
-it's visible on all sites.
+it's visible on all sites. All users with permission on the blog can manage all the blog
+posts, whichever the sites are.
+
+Multisite permissions
+^^^^^^^^^^^^^^^^^^^^^
 
-This is matched with and API that allows to restrict users to only be able to edit
-blog posts only for some sites.
+Multisite permissions allow to restrict users to only manage the blog posts for the
+sites they are enabled to
 
-To implement this API, you must add a ``get_sites`` method on the user model which
-returns a queryset of sites the user is allowed to add posts to.
+To implement the multisite permissions API, you must add a ``get_sites`` method on
+the user model which returns a queryset of sites the user is allowed to add posts to.
 
 Example::