build: automation & make content enhancement

Author: practicalli-johnny

docs/automation/index.md

@@ -4,7 +4,7 @@ Automation tools can provide a consistent command line interface across a wide r
 
 Whilst the Clojure CLI is a very extensible tool that flexibility can also add some complexity to its command line interface.
 
-Using a consistent set of user aliases can help manage the command line interface, however, automation tools can abstract the command line task even further to provide a consistent and simple to user experience whilst keeping the underlying flexibility.
+Automation tools abstract the command line to provide a consistent and simple user experience whilst keeping underlying flexibility.
 
 !!! HINT "Practicalli recommends make"
     A Makefile is not reliant on programming language knowledge so has no barrier to those who are unfamiliar with the Clojure language.
@@ -47,4 +47,3 @@ Write automation scripts with Clojure code using the [Babashka task runner](http
 Babashka can use a wide range of Clojure functions and libraries, although as a general script tool then additional coding and maintenance may be reqiured compared to a dedicated tool.
 
 [Babashka task runner](https://book.babashka.org/#tasks){target=_blank .md-button}
-

docs/automation/make.md

@@ -4,7 +4,9 @@
 
 [GNU Make](https://www.gnu.org/software/make/manual/html_node/Standard-Targets.html) provide a simple and consistent way to run any development task for Clojure & ClojureScript projects (or any other languages).
 
-Wrap any combination of tools (building, linting, formatting, testing) with make targets for a simple command line interface, with automatically tab completion, making any Clojure project really easy to work with.  Practicalli also uses make to manage docker images and containers to support Clojure development.
+Wrap any combination of tools (building, linting, formatting, testing) with Make targets for a simple command line interface.
+
+Make supports tab completion making tasks discoverable.
 
 All that is required is [a `Makefile` in the root of the project](https://github.com/practicalli/dotfiles/blob/main/Makefile)
 
@@ -89,7 +91,7 @@ deps: deps.edn  ## Prepare dependencies for test and dist targets
 > `:test/env` adds libraries to run Kaocha and libraries used to run unit tests.  `:package/uberjar` runs a tool that creates an uberjar.
 
 
-## Clean target - hiding command failure
+## Clean target - hiding command errors
 
 The clean target should remove files and directories created by the build (compile) process, to ensure a consistent approach to building each time.
 
@@ -153,7 +155,7 @@ Although unlikely, if a filename in the root of a project has the same name as a
 [phony - MakefileTutorial](https://makefiletutorial.com/#phony){target=_blank .md-button}
 
 
-## Halt on failure
+## Halt on error
 
 `.DELETE_ON_ERROR:` halts any further commands if a command returns non-zero exit status.  Useful as short-circuit to stop tasks when further work is not valuable, e.g. if tests fail then it may not be valuable to build the Clojure project.