intro: tools & library section rewrite for greater clarity

Resolve: #128

Author: practicalli-johnny

docs/index.md

@@ -12,11 +12,11 @@ Use a [REPL Workflow approach](introduction/repl-workflow.md) to provide instant
 
 Clojure CLI is used to manage library dependencies and run Clojure code, enhanced with [aliases from Practicalli Clojure CLI Config](https://practical.li/clojure/clojure-cli/practicalli-config/).
 
-Larger projects use Integrant & Integrant REPL to manage components and state, using a reloaded REPL workflow to manage changes in addtion to evaluating functions in the REPL.
+Larger projects use [donut.system](service-repl-workflow/donut-system.md) (or Integrant & Integrant REPL) to manage components and state, using a reloaded REPL workflow to manage changes in addition to evaluating functions in the REPL.
 
-Persistence is provides via Postgresql (and eventually JUXT Crux)
+Postgresql is used for persistent storage, with next.jdbc and honeysql for database access (SQL). Additional persistence tools and services will be added in future.
 
-tools.build will be used to create Clojure artefacts for deployment, with GitHub actions and Docker used for Continuous Integration and orchestrating systems.
+tools.build is used to create Clojure artefacts for deployment, with GitHub actions and Docker used for Continuous Integration and orchestrating systems.
 
 make is a general build tool used to support project development and support automation of wokflow tasks.
 
@@ -26,15 +26,18 @@ make is a general build tool used to support project development and support aut
 ??? WARNING "Older content using Leiningen"
     Older content uses Leiningen for project configuration.  This content can be converted to a Clojure CLI project by creating a `deps.edn` file containing the relevant dependencies.  Add a `build.clj` configuration to create assets to deploy, e.g. jar & uberjar.
 
+!!! INFO "Project Templates"
+    Practicalli Project templates can be used with the deps-new tool to create a new project with common libraries and code to show how those libraries can be wired together.
+    Practicalli Clojure Web Services guides will include a template for each of the projects in this book (WIP).
+
 
 ## Library Composition approach
 
 The Clojure community provides a diverse set of libraries, each focused on a specific need. Libraries are assembled to rapidly develop a tailored solution, avoiding bloat and the unnecessary complexity that comes with large frameworks. Libraries are relatively simple to replace with alternatives or used as inspiration for your own custom functions.
 
-Templates can be used to create example projects with common libraries, with code to show showing how libraries can be wired together.
-provide examples of libraries working together.
 
-??? INFO "Avoiding large frameworks"
+
+??? INFO "Avoid the complexity and inflexibility of large frameworks"
     Frameworks are design decisions others have made and generalised to solve a range of problem, so there is no guarantee on how many of those decisions are relevant for the current project.
 
     Frameworks tend to include many features not relevant to the current problem, which can be challenging to remove or replace. Frameworks can be over relied upon, taking away an opportunity to think about the most relevant solution.