From fdc05ecf4899bcb9ad7883a3288224e4c65e6e21 Mon Sep 17 00:00:00 2001
From: Elena ``of Valhalla'' Grandi <valhalla@trueelena.org>
Date: Mon, 22 Mar 2021 21:47:39 +0100
Subject: Improved docs (getting started).

---
 docs/source/user/getting_started_command_line.rst | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

(limited to 'docs')

diff --git a/docs/source/user/getting_started_command_line.rst b/docs/source/user/getting_started_command_line.rst
index 0c4d507..04913d7 100644
--- a/docs/source/user/getting_started_command_line.rst
+++ b/docs/source/user/getting_started_command_line.rst
@@ -21,9 +21,11 @@ including a ``settings.yaml`` skeleton and it will initialize a git
 repository (use ``--no-git`` to skip this part and ignore all further
 git commands).
 
-It will then open ``settings.yaml`` in an editor: fill in your list of
-fields and all other data, save and exit.
-You are now ready to commit the configuration for your new collection::
+It will then open ``settings.yaml`` in an editor: fill in your values
+for the available variables, and define your list of fields; see
+:doc:`settings` for details. Then save and exit, and you are now ready to
+commit the configuration for your new collection, as the changes have
+already been added to git::
 
     git commit -m 'Collection settings'
 
@@ -54,9 +56,15 @@ for your query you can use the option ``--all``. This is especially
 useful when passing the results to a template::
 
    lesana search --template templates/my_report.html --all \
-       some search terms \
+       <some search terms> \
        > some_search_terms-report.html
 
 will generate an html file based on the jinja2 template
 ``templates/my_report.html`` with all the entries found for those search
 terms.
+
+If later on you want to clone the repository elsewhere (using regular
+git commands) you can use ``git init`` in the new repository to install
+the hooks to manage updating the local cache every time the repository
+is updated via git, and then run ``lesana index`` to prepare the first
+version of the cache.
-- 
cgit v1.2.3