Apply suggestions from code review

Co-authored-by: Grégoire Paris <[email protected]>

Author: linawolf

docs/cli/configuration.rst

@@ -8,7 +8,7 @@ The cli tool is able to read configuration from a ``guides.xml`` file.
 You should put this file in the current working directory where you execute
 the tool. Generally speaking, this is the root of your project.
 
-Using a configuration file allows you to set project specific settings and
+Using a configuration file allows you to set project-specific settings and
 keep them under version control. Not all options available in the configuration
 are available on the command line. Such as the :ref:`extension configuration`.
 

docs/cli/index.rst

@@ -12,7 +12,7 @@ Create your first documentation
 ===============================
 
 After :doc:`/installation` you can directly start to create your first documentation.
-to do this create a new directory named ``docs`` and create a file called ``index.rst`` in it.
+to do this, create a new directory named ``docs`` and create a file called ``index.rst`` in it.
 
 .. code-block:: rst
 
@@ -49,6 +49,6 @@ to learn more about the configuration.
 Extending
 =========
 
-Like any other component in this repository the commandline tool can be extended. This can
-be done using an extension class. And reference this class in the configuration file. Like
+Like any other component in this repository, the commandline tool can be extended. This can
+be done using an extension class, and referencing this class in the configuration file, like
 shown for in the :ref:`.extension-configuration` section.

docs/index.rst

@@ -22,7 +22,7 @@ your documentation from `reStructuredText Markup <https://docutils.sourceforge.i
 formats.
 
 Besides the commandline tool it also provides a number of libraries that can be used to build your own application
-to render the supported formats. To any format you want. On these pages is explained how to use the commandline tool
+to render the supported formats, to any format you want. On these pages is explained how to use the commandline tool
 and how to use the libraries.
 
 If you are looking for a complete solution to create a documentation website then you may want to look at

docs/installation.rst

@@ -27,11 +27,11 @@ This will install the commandline tool in the vendor/bin directory. You can then
 
     vendor/bin/guides ./docs
 
-The commandline tool is build for extension, if you do not have special needs this is the
+The commandline tool is built for extension, if you do not have special needs this is the
 recommended way to get started. You can learn more about how to extend the commandline tool in the :doc:`/cli/index` section.
 
 Library (advanced)
-===============================
+==================
 
 .. _library:
 

docs/reference/restructuredtext/admonitions.rst

@@ -7,7 +7,7 @@ Admonitions
 ===========
 
 Admonitions are blocks of text that are rendered in a special way to draw attention to them. They are often used to
-provide additional information to the reader about the content that is being discussed. t6est
+provide additional information to the reader about the content that is being discussed.
 
 .. index:: reST directives; seealso