aliases: update documentation and formatting

- add clojure command and execution flag for each alias
- move :repl/clerk to REPL section
- move :lib/integrant-repl & :lib/component-repl to development environment section

Author: practicalli-johnny

CHANGELOG.org

@@ -14,6 +14,7 @@
    - Removed: `:lib/scope-capture` - use cider-debug or `:lib/flowstorm` or Portal data inspector
    - Removed: `:alpha/closh` - project only proof of concept
    - `:test/env` - remove `pjstadig/humane-test-output` library as it requires activation
+   - update documentation and formatting
 
 * 2023-10-17
 ** Added

README.md

@@ -657,23 +657,34 @@ Take care to get the timezone notation correct.
 
 ## Library Hosting Services
 
-Repositories that host libraries for Clojure.
+Clojure libraries are packaged as Java Archive (JAR) files and distributed by Maven style repositories. A Clojure project configuration defines library dependencies that are satisfied by downloading jar files from the collective repository sources.
 
-`central` and `clojars` are the man repositories for Clojure development are consulted in order.
+`central` and `clojars` are defined in the Clojure CLI installation configuration and are the main repositories for Clojure development.
 
-`central` and `clojars` repos can be removed from consideration by setting their configuration hash-map to `nil` in `~/.clojure/deps.edn`.  For example, `{:mvn/repos {"central" nil}}`.
+* `central` - Maven Central, the canonical repository for JVM libraries, including Clojure releases
+* `clojars` - [clojars.org](https://repo.clojars.org/), the canonical repositories for Clojure community libraries fronted by a contend delivery network service
+
+```clojure
+ :mvn/repos
+ {"central" {:url "https://repo1.maven.org/maven2/"}
+  "clojars" {:url "https://repo.clojars.org/"}}
+```
 
-The order of additional repositories consulted is not guaranteed, so may cause unpredictable side effects in the project build especially if `RELEASE` or `LATEST` tags are used rather than a numeric library version.
+`central` and `clojars` repos can be removed by setting their configuration  to `nil` in the user or project `deps.edn` configuration. 
 
-Maven supports [explicit mirror definition](https://maven.apache.org/guides/mini/guide-mirror-settings.html) in `~/.m2/settings.xml` and Clojure CLI  supports this configuration.  Adding Maven Central or a mirror to  `~/.m2/settings.xml` negates the need for its entry in deps.edn configuration.
+```clojure
+`:mvn/repos 
+ {"central" nil
+  "clojars" nil}
+```
 
-### Recommended repositories
+Maven supports [explicit mirror definition](https://maven.apache.org/guides/mini/guide-mirror-settings.html) in `~/.m2/settings.xml` and Clojure CLI  supports this configuration.  Adding Maven Central or a mirror to  `~/.m2/settings.xml` negates the need for its entry in deps.edn configuration.
 
-* `central` - Maven Central, the canonical repository for JVM libraries, including Clojure releases
-* `clojars` - [clojars.org](https://repo.clojars.org/), the canonical repositories for Clojure community libraries fronted by a contend delivery network service
 
 ### Optional repositories
 
+The order of additional repositories consulted is not guaranteed, so may cause unpredictable side effects in the project build especially if `RELEASE` or `LATEST` tags are used rather than a specifice numerical version.
+
 * `sonatype` - [snapshots of Clojure development releases](https://oss.sonatype.org/), useful for testing against before new stable releases.
 * `business-area` - example of adding a local Artifactory server for your team or business area.
 * `google-maven-central` - [Maven Central mirror hosted on Google Cloud Storage](https://storage-download.googleapis.com/maven-central/index.html) - Americas, Asia, Europe
@@ -706,7 +717,7 @@ Example of local Artifactory repository configuration
  "clojars" {:url "https://repo.clojars.org/"}}
 ```
 
-### Asian Region Mirrors
+### Asia Region Mirrors
 
 ```clojure
  :mvn/repos
@@ -721,10 +732,16 @@ Example of local Artifactory repository configuration
 
 ## Maven local repository
 
-Define a local Maven repository.  Useful if you wish to specify an alternative to the default `~/.m2/` directory.
+Specify a local repository for maven, as an alternative to the default location: `$HOME/.m2/repository`
+
+FreeDesktop.org `XDG_CACHE_HOME` is the recommended location for an alternative Maven local repository.
 
 ```clojure
- :mvn/local-repo "/cache/.m2"
+:mvn/local-repo "/home/practicalli/.cache/maven/repository"
 ```
 
+> NOTE: The full path should be specified, otherwise a relative directory path will be created
+
+`clojure -Spath` will show the current class path which will include the path to the local maven repository for the library dependencies.
+
 > NOTE: using `clojure -Sforce` forces a classpath recompute, deleting the contents of .cpcache