Addressing review comments.

Author: Dmitri Zimine

docs/source/packs.rst

@@ -28,9 +28,11 @@ Managing Packs
     Exchange <https://exchange.stackstorm.org>`_. To make it happen, we deprecated few old things.
     Check the :doc:`upgrade notes </upgrade_notes>` and :doc:`/reference/pack_management_transition`.
 
-|st2| packs are managed through ``st2 pack ...`` commands: ``st2 pack -h`` will give you a useful overview if you just need a quick start.
+|st2| packs are managed through ``st2 pack ...`` commands: ``st2 pack -h`` will give you a useful
+overview if you just need a quick start.
 
-A few packs (such as the ``core`` pack for basic StackStorm actions) come pre-installed with StackStorm. ``list`` and ``get`` are the primary commands to work with local packs:
+A few packs (such as the ``core`` pack for basic StackStorm actions) come pre-installed
+with StackStorm. ``list`` and ``get`` are the primary commands to work with local packs:
 
 .. code-block:: bash
 
@@ -153,7 +155,7 @@ The value must be a colon delimited string of directory paths. For example:
 Directories are always searched from left to right in the order they are
 specified, with the system packs directory always searched first.
 
-Pack configuration is represented by ```/opt/stackstorm/<packname>.yaml``` and must
+Pack configuration is represented by ```/opt/stackstorm/configs/<packname>.yaml``` and must
 conform to a configuration schema, ```config.schema.yaml``` file in pack's directory.
 Details of this powerful functionaltiy are in :doc:`/reference/pack_configs` section.
 

docs/source/reference/pack_management_transition.rst

@@ -27,7 +27,7 @@ Good bye st2contrib, long live StackStorm Exchange
 --------------------------------------------------
 
 `StackStorm Exchange <https://exchange.stackstorm.org/>`__ is the new pack index maintained by the StackStorm team. Any pack from StackStorm Exchange can be installed with ``st2 pack install <pack>``
-in the CLI. No WebUI support yet.
+in the CLI.
 
 Exchange packs are hosted in the `StackStorm-Exchange  organization
 <https://github.com/stackstorm-exchange>`__  on GitHub. To submit **a new pack** to the StackStorm Exchange, follow the instructions in

docs/source/reference/packs.rst

@@ -26,7 +26,7 @@ Canonical pack as laid out on the file system.
     requirements-tests.txt   # requirements for python tests
     icon.png                 # 64x64 .png icon
 
-Some old packs also have a configuration file at ``/opt/stackstorm/configs/<pack_name>.yaml``
+Some old packs also have a configuration file at ``/opt/stackstorm/<pack_name>/config.yaml``
 that defines any shared configuration used by the actions and sensors, e.g. usernames, region names, hostnames, etc. New pack rely on :doc:`configuration schema</reference/pack_configs>` and keep their configuration files under ``/opt/stackstorm/configs```.
 
 At the topmost level are the main folders ``actions``, ``rules``, ``sensors``, ``aliases`` and ``policies`` as well as some shared files:
@@ -158,9 +158,9 @@ The following example simply echoes a greeting.
 
   .. literalinclude:: /../../st2/contrib/hello_st2/policies/policy1.yaml
 
-8. Install the pack. We encourage using git, if you do so, ``st2 pack`` will greatly simplify
-your pack management. However you can figure out your own workflow for editing and versioning packs;
-you'll be placing the files to ``/opt/stackstorm/packs`` and [re-]loading the content.
+8. Install the pack. We encourage using git, if you do so, ``st2 pack`` will greatly simplify your
+pack management. However you can define your own tools and workflow for editing and versioning
+packs; you'll be placing the files to ``/opt/stackstorm/packs`` and [re-]loading the content.
 
   7.1 Use git and ``pack install`` (**recommended**):
 
@@ -173,7 +173,7 @@ you'll be placing the files to ``/opt/stackstorm/packs`` and [re-]loading the co
     st2 pack install file:///$PWD
 
   When you make code changes, ``run st2 pack install`` again: it will do the upgrade.
-  Once you push it to GitHub, you could install or update it right from there: ::
+  Once you push it to GitHub, you will install and update it right from there: ::
 
     st2 pack install https://github.com/MY/PACK