docs(readme): 📝 update summary and add contributing links

Author: practicalli-johnny

CHANGELOG.md

@@ -10,6 +10,7 @@
 - build(make): 🔧 practicalli tasks for zensical
 - build(zensical): 💄 overrides updated for zensical
 - build(zensical): 💄 add automatic palette for light or dark
+- docs(readme): 📝 update summary and add contributing links
 
 ## 2023-03-10
 ### Added

README.md

@@ -1,9 +1,21 @@
-## ARCHIVED
+# Practicalli ClojureScript
 
-Retired content.
+```none
+██████╗ ██████╗  █████╗  ██████╗████████╗██╗ ██████╗ █████╗ ██╗     ██╗     ██╗
+██╔══██╗██╔══██╗██╔══██╗██╔════╝╚══██╔══╝██║██╔════╝██╔══██╗██║     ██║     ██║
+██████╔╝██████╔╝███████║██║        ██║   ██║██║     ███████║██║     ██║     ██║
+██╔═══╝ ██╔══██╗██╔══██║██║        ██║   ██║██║     ██╔══██║██║     ██║     ██║
+██║     ██║  ██║██║  ██║╚██████╗   ██║   ██║╚██████╗██║  ██║███████╗███████╗██║
+╚═╝     ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝   ╚═╝   ╚═╝ ╚═════╝╚═╝  ╚═╝╚══════╝╚══════╝╚═╝
 
 
-## Summary
+> NOTE: Ascii Art Generator: https://patorjk.com/software/taag/#p=display&f=ANSI%20Shadow&t=Practicalli%205
+
+## Book Overview
+
+A guide to software development with the ClojureScript programming language, using Clojure CLI and a wide range of community tools for a REPL focused workflow.
+
+The guide uses Practicalli Clojure CLI Config to provide aliases to run over 30 community tools that complement the workflow, including a REPL Reloaded workflow for a highly interactive and effective development experience.
 
 Learn how to develop simple client-side web applications using the ClojureScript programming language, a functional programming language compiled to JavaScript.
 
@@ -13,7 +25,8 @@ Figwheel-main is a build tool which provides a highly interactive development wo
 
 Reagent, a react-style library, is used for single page applications.  Hiccup and Selma are used for managing content.
 
-Clojure CLI provides an array of tools to support development, using project and user `deps.edn` configuration files.
+
+Learning ClojureScript syntax and how to think in a functional design is also covered with code examples and challenge that help embed these concepts.
 
 
 ## Creative commons license
@@ -23,6 +36,20 @@ Clojure CLI provides an array of tools to support development, using project and
   This work is licensed under a Creative Commons Attribution 4.0 ShareAlike License (including images & stylesheets).
 </div>
 
+## Contributing
+
+Issues and pull requests are most welcome although it is the maintainers discression as to if they are applicable.  Please detail issues as much as you can.  Pull requests are simpler to work with when they are specific to a page or at most a section.  The smaller the change the quicker it is to review and merge.
+
+Please read the [detailed Practicalli contributing page](https://practical.li/contributing/) before raising an issue or pull request to avoid disappointment.
+
+* [Current Issues](https://github.com/practicalli/clojurescript/issues)
+* [Current pull requests](https://github.com/practicalli/clojurescript/pulls)
+
+[Practicalli Clojure CLI Config](clojure/clojure-cli/practicalli-config.md) provides a user level configuration providing aliases for community tools used throughout this guide.  Issues and pull requests can also be made via its GitHub repository.
+
+By submitting content ideas and corrections you are agreeing they can be used in this workshop under the [Creative Commons Attribution ShareAlike 4.0 International license](https://creativecommons.org/licenses/by-sa/4.0/).  Attribution will be detailed via [GitHub contributors](https://github.com/practicalli/engineering-playbook/graphs/contributors).
+
+
 ## Sponsor Practicalli
 
 [![Sponsor Practicalli via GitHub](https://raw.githubusercontent.com/practicalli/graphic-design/live/buttons/practicalli-github-sponsors-button.png)](https://github.com/sponsors/practicalli-johnny/)
@@ -37,3 +64,62 @@ Thanks to [Cognitect](https://www.cognitect.com/), [Nubank](https://nubank.com.b
 [![Star History Chart](https://api.star-history.com/svg?repos=practicalli/clojurescript&type=Date)](https://star-history.com/#practicalli/clojurescript&Date)
 
 
+## GitHub Actions
+
+The megalinter GitHub actions will run when a pull request is created,checking basic markdown syntax.
+
+A review of the change will be carried out by the Practicalli team and the PR merged if the change is acceptable.
+
+The Publish Book GitHub action will run when PR's are merged into main (or the Practicalli team pushes changes to the default branch).
+
+Publish book workflow installs Material for MkDocs version 9
+
+
+## Local development
+
+Zensical can be installed locally via vu or pip.  Practicalli uses uv and installs Zensical as a tool for simplicity.
+
+CLI Commands are wrapped in tasks defined within the `Makefile`, providing a simpler and consistent user experience.
+
+[Zensical - Practcialli Engineering Playbook](https://practical.li/engineering-playbook/technical-writing/static-site/zensical/)
+
+Clone the repository and change into the root of the project.
+
+```shell
+git clone https://github.com/practicalli/clojurescript
+```
+
+Install Zensical as a tool using `uv` (updating if there is a new version).
+
+```shell
+make docs-install
+```
+
+Or use the uv command:
+
+```shell
+uv tool install zensical --with catppuccin-zensical --upgrade
+```
+
+
+Build the website and serve locally at [http://localhost:8000](http://localhost:8000)
+
+```shell
+make docs
+```
+
+Or use the zensical command:
+
+```shell
+zensical serve --dev-addr localhost:7777
+```
+
+---
+
+Specific command if now using make:
+
+Create a virtual python in the root of the project.
+
+```shell
+uv tool install zensical --upgrade
+```