# HG changeset patch
# User Laurent Peuch <cortex@worlddomination.be>
# Date 1549979332 -3600
# Node ID 72fced7549e6fc4a5f1de5a85c4a2a389a662cac
# Parent  37bfcaa1792d7c7bc6d718f90c841fed5d8d51f0
[doc] improve blog tutorial first steps and explain common errors

diff -r 37bfcaa1792d -r 72fced7549e6 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.