[doc] improve blog tutorial first steps and explain common errors
authorLaurent Peuch <cortex@worlddomination.be>
Tue, 12 Feb 2019 14:48:52 +0100
changeset 12363 72fced7549e6
parent 12361 37bfcaa1792d
child 12364 64a72b2c9c27
[doc] improve blog tutorial first steps and explain common errors
doc/tutorials/base/blog-in-five-minutes.rst
--- a/doc/tutorials/base/blog-in-five-minutes.rst	Tue Feb 12 11:38:19 2019 +0100
+++ b/doc/tutorials/base/blog-in-five-minutes.rst	Tue Feb 12 14:48:52 2019 +0100
@@ -17,6 +17,14 @@
 
     cubicweb-ctl create blog myblog
 
+The `blog` argument is the cube on which you want to base your instance and
+`myblog` is the name of your instance.
+
+.. Note::
+
+   If you get an a permission error of this kind `OSError: [Errno 13]
+   Permission denied: '/etc/cubicweb.d/myblog'`, read the :ref:`next section`.
+
 You'll be asked a few questions, and you can keep the default answer for most of
 them. The one question you'll have to think about is the database you'll want to
 use for that instance. For a quick test, if you don't have `postgresql` installed
@@ -33,6 +41,7 @@
 as a daemon in the background, and ``cubicweb-ctl stop myblog`` will stop
 it in that case. 
 
+.. _AboutFileSystemPermissions:
 
 About file system permissions
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -62,7 +71,7 @@
      cubicweb-ctl db-create myblog
 
 Other parameters, like web server or emails parameters, can be modified in the
-:file:`/etc/cubicweb.d/myblog/all-in-one.conf` file.
+:file:`/etc/cubicweb.d/myblog/all-in-one.conf` file (or :file:`~/etc/cubicweb.d/myblog/all-in-one.conf` depending on your configuration.)
 
 You'll have to restart the instance after modification in one of those files.