From 1e47efa6ed79a6f4af5032927099ce6277bc3f7a Mon Sep 17 00:00:00 2001
From: Nils Philippsen <nils@redhat.com>
Date: Aug 21 2017 14:47:19 +0000
Subject: some polishing (wording, formatting)


---

diff --git a/source/development/building-modules/building-local.rst b/source/development/building-modules/building-local.rst
index da05996..bcf2d26 100644
--- a/source/development/building-modules/building-local.rst
+++ b/source/development/building-modules/building-local.rst
@@ -5,7 +5,7 @@ To build a modulemd, you need to have the
 `Module Build Service <https://pagure.io/fm-orchestrator>`__
 installed on your system.
 
-Install it by:
+Install it like this:
 
 ::
 
@@ -15,24 +15,26 @@ Install it by:
 due to a missing runtime dependency declaration in the
 ``module-build-service`` RPM.
 
-Then add your user name to the mock group:
+Then add your user to the mock group:
 
 ::
 
     $ sudo usermod -a -G mock myusername
 
-To build your module, run a command similar to the following in local git
-repository with your module:
+To build your module, run a command similar to the following in the local git
+repository of your module:
 
 ::
 
     $ mbs-build local
 
-An output will be a yum/dnf repository beneath the modulebuild directory in the
-home of the user.
+With the default configuration, this should generate a yum/dnf repository
+beneath the directory ``modulebuild`` in the home of the user.
 
 To test your local build environment on Fedora, the ``haproxy`` module is a
-reasonable example module to start with::
+reasonable example module to start with:
+
+::
 
     $ fedpkg clone --branch f26 modules/haproxy
     $ cd haproxy
@@ -52,29 +54,30 @@ reasonable example module to start with::
 Building against other locally built modules
 --------------------------------------------
 
-Normally, the Module Build Service obtains all the build-time dependencies of
-your module from the Koji server. In case you want to build multiple modules
-depending on each other, you can do it by ``--add-local-build`` (or ``-l``)
-Module Build Service option.
+Normally, the module build service obtains all build-time dependencies of your
+module from the Koji server. If you want to build multiple modules depending on
+each other you can do that by using the ``--add-local-build`` (or ``-l``)
+option of ``mbs-build``.
 
-Note that this option is available only in Module Build Service version 1.3.26 and
-higher.
+.. note::
+    This option is only available in version 1.3.26 or later of the module
+    build service.
 
-For example, to build a module against local build of ``perl`` module, you
-can do following:
+For example, to build a module against a locally built ``perl`` module, you
+can do the following:
 
 ::
 
     $ mbs-build local --add-local-build perl
 
-You can also specify multiple local module builds like this:
+Specify multiple local module builds like this:
 
 ::
 
     $ msb-build local --add-local-build perl --add-local-build python
 
-You can even specify particular stream and version of the local module builds
-which should be used as a dependencies:
+You can even specify particular streams and versions of local module builds
+which should be used as dependencies:
 
 ::