Updated documentation for global directory

Author: nwinkler

DEVELOPMENT.md

@@ -27,17 +27,19 @@ This order is subject to change.
 
 For `aliases`, `plugins` and `completions`, the following rules are applied that influence the load order:
 
-* Each type has its own `enabled` directory, into which the enabled components are linked into. Enabled plugins are symlinked from `$BASH_IT/plugins/available` to `$BASH_IT/plugins/enabled` for example.
-* Within each of the `enabled` directories, the files are loaded in alphabetical order.
+* There is a global `enabled` directory, which the enabled components are linked into. Enabled plugins are symlinked from `$BASH_IT/plugins/available` to `$BASH_IT/enabled` for example. All component types are linked into the same common `$BASH_IT/enabled` directory.
+* Within the common `enabled` directories, the files are loaded in alphabetical order, which is based on the item's load priority (see next item).
 * When enabling a component, a _load priority_ is assigned to the file. The following default priorities are used:
     * Aliases: 150
     * Plugins: 250
     * Completions: 350
-* When symlinking a component into an `enabled` directory, the load priority is used as a prefix for the linked name, separated with three dashes from the name of the component. The `node.plugin.bash` would be symlinked to `250---node.plugin.bash` for example.
+* When symlinking a component into the `enabled` directory, the load priority is used as a prefix for the linked name, separated with three dashes from the name of the component. The `node.plugin.bash` would be symlinked to `250---node.plugin.bash` for example.
 * Each file can override the default load priority by specifying a new value. To do this, the file needs to include a comment in the following form. This example would cause the `node.plugin.bash` (if included in that file) to be linked to `225---node.plugin.bash`:
 
   ```bash
   # BASH_IT_LOAD_PRIORITY: 225
   ```
 
+Having the order based on a numeric priority in a common directory allows for more flexibility. While in general, aliases are loaded first (since their default priority is 150), it's possible to load some aliases after the plugins, or some plugins after completions by setting the items' load priority. This is more flexible than a fixed type-based order or a strict alphabetical order based on name.
+
 These items are subject to change. When making changes to the internal functionality, this page needs to be updated as well.

test/README.md

@@ -1,4 +1,13 @@
 ## Testing with [Bats](https://github.com/sstephenson/bats#installing-bats-from-source)
+
+To execute the unit tests, please run the `run` script:
+
+```bash
+# If you are in the `test` directory:
+./run
+
+# If you are in the root `.bash_it` directory:
+test/run
 ```
-bats test/{lib,plugins}
-```
+
+The `run` script will automatically install [Bats](https://github.com/sstephenson/bats#installing-bats-from-source) if it is not already present, and will then run all tests found under the `test` directory, including subdirectories.