[BZ-1219310] add a doc section explaining sub-command overrides

Signed-off-by: Alfredo Deza <adeza@redhat.com>

diff --git a/docs/source/conf.rst b/docs/source/conf.rst
index cd45d9717867c6f164497e6c7144d0b7a08b83f4..28b88c86d44fffdbba8ae901564a9737a7e36a40 100644 (file)
--- a/docs/source/conf.rst
+++ b/docs/source/conf.rst
@@ -80,6 +80,25 @@ a repository.
 Repositories can be very complex to describe and most of the time (specially
 for yum repositories) they can be very verbose too.
 
+Setting Default Flags or Values
+-------------------------------
+Because the configuration loading allows specifying the same flags as in the
+CLI it is possible to set defaults. For example, assuming that a user always
+wants to install Ceph the following way (that doesn't create/modify remote repo
+files)::
+
+    ceph-deploy install --no-adjust-repos {nodes}
+
+This can be the default behavior by setting it in the right section in the
+configuration file, which should look like this::
+
+    [ceph-deploy-install]
+    adjust_repos = False
+
+The default for ``adjust_repos`` is ``True``, but because we are changing this
+to ``False`` the CLI will now have this behavior changed without the need to
+pass any flag.
+
 Repository Sections
 -------------------
 Keys will depend on the type of package manager that will use it. Certain keys