housekeeping

docs/sphinx/showroom.rst

 Showroom
 ========
 
-"What can I use Maestro Core for?"
+"What can we use Maestro Core for?"
 
 
 Overview

docs/sphinx/stories.rst

 Users' Stories
 ==============
 
-"How can I do [...] with Maestro Core?"
+"How can we do [...] with Maestro Core?"
 
 .. _user-metadata:
 
@@ -26,8 +26,8 @@ Users may define their own metadata, using a YAML schema:
                       Maestro Core will issue a warning.
      ...
 
-The schema syntax may be checked against Maestro Core meta-schema with `yamale
-<https://github.com/23andMe/Yamale>`__
+The schema syntax may be checked against Maestro Core meta-schema with a
+dedicated tool such as `yamale <https://github.com/23andMe/Yamale>`__
 
 .. code-block:: shell
 

docs/sphinx/tuning.rst

@@ -10,6 +10,10 @@ Maestro features a range of environment variables, the full list and doc follows
 Maestro is relying on OFI for network operations, therefore the usual OFI knobs
 can also be played with.
 
+.. attention::
+   The following variables are the C-sides ones as extracted from doxygen. To get the environment variable name, just remove ``ENV_`` from the name.
+  
+
 .. doxygengroup:: MSTRO_ENV
 
 Telemetry