Skip to content

Commit 457c193

Browse files
intro: update book descriptions, add editor config links
1 parent ebd81f4 commit 457c193

File tree

1 file changed

+16
-11
lines changed

1 file changed

+16
-11
lines changed

docs/books.md

+16-11
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33

44
## Engineering Playbook
55

6-
Practical guides for specific tools and practices to support software development.
6+
Practical guides for specific tools and practices to support software development.
77

88
[![Practicalli Engineering Playbook Book](https://raw.githubusercontent.com/practicalli/graphic-design/live/engineering-playbook/engineering-playbook-concept.png){loading=lazy}](https://practical.li/engineering-playbook){target=_blank}
99

@@ -18,22 +18,19 @@ Practice Clojure by solving challenges with examples of different approaches. En
1818

1919
[![Practicalli Clojure Book](https://github.com/practicalli/graphic-design/blob/live/clojure/clojure-repl-workflow-concept.png?raw=true){loading=lazy}](https://practical.li/clojure){target=_blank}
2020

21-
[:fontawesome-solid-book-open: Practicalli Clojure](https://practical.li/clojure){target=_blank .md-button}
21+
[:fontawesome-solid-book-open: Practicalli Clojure](https://practical.li/clojure){target=_blank .md-button}
22+
[:fontawesome-brands-github: Clojure CLI Config](https://github.com/practicalli/clojure-cli-config){target=_blank .md-button}
2223

2324

2425
## Clojure Web Services
2526

26-
Building services with APIs
27+
Build production level server-side web services and API's in Clojure.
2728

28-
Build production level server-side web services, micro-services and API's in Clojure.
29+
Ring converts each HTTP request to a hash-map. Define routes to middleware & handler functions to process requests and return a Ring response.
2930

30-
Using Ring as an abstraction over HTTP with requests and responses as simple Clojure hash-maps.
31+
Data formats are managed by coercion and content negotiation, optionally using specifications to ensure data validation.
3132

32-
Routing of requests are managed by Compojure or Reitit, passing requests to handers which are Clojure functions.
33-
34-
Data formats are managed by coercion and content negotiation.
35-
36-
OpenAPI (swagger) is used for self-documenting APIs
33+
OpenAPI (swagger) is used for self-documenting APIs and testing.
3734

3835
[![Practicalli Clojure Web Services Book](https://raw.githubusercontent.com/practicalli/graphic-design/live/book-covers/practicalli-clojure-web-service-book-banner-light.png#only-light){loading=lazy}](https://practical.li/clojure-web-services){target=_blank}
3936
[![Practicalli Clojure Web Services Book](https://raw.githubusercontent.com/practicalli/graphic-design/live/book-covers/practicalli-clojure-web-service-book-banner-dark.png#only-dark){loading=lazy}](https://practical.li/clojure-web-services){target=_blank}
@@ -43,11 +40,14 @@ OpenAPI (swagger) is used for self-documenting APIs
4340

4441
## Spacemacs (Emacs)
4542

46-
powerful editing with Emacs and Vim multi-modal editing, with a mnemonic menu that simplifies the learning curve. Install a full Clojure development experience with two Git commands.
43+
Powerful editing with Emacs and Vim multi-modal editing (Evil). A mnemonic menu simplifies the learning curve.
44+
45+
Install a full Clojure development experience with two Git clone commands.
4746

4847
[![Practicalli Spacemacs Book](https://raw.githubusercontent.com/practicalli/graphic-design/live/book-covers/practicalli-spacemacs-book-banner.png){loading=lazy}](https://practical.li/spacemacs){target=_blank}
4948

5049
[:fontawesome-solid-book-open: Practicalli Spacemacs](https://practical.li/spacemacs){target=_blank .md-button}
50+
[:fontawesome-brands-github: Spacemacs Config](https://github.com/practicalli/spacemacs-config){target=_blank .md-button}
5151

5252

5353
## Neovim
@@ -60,6 +60,9 @@ Neovim for effective Clojure development with Conjure and Clojure LSP (nvim-tree
6060
[![Practicalli Neovim Book](https://raw.githubusercontent.com/practicalli/graphic-design/live/book-covers/practicalli-neovim-book-banner-astronvim.png){loading=lazy}](https://practical.li/neovim){target=_blank}
6161

6262
[:fontawesome-solid-book-open: Practicalli Neovim](https://practical.li/neovim){target=_blank .md-button}
63+
[:fontawesome-brands-github: Astro5 Neovim Config](https://github.com/practicalli/nvim-astro5){target=_blank .md-button}
64+
65+
---
6366

6467
# Under development
6568

@@ -75,6 +78,7 @@ build single page apps (SPA's), dynamic UI's and mobile apps with responsive des
7578
[:fontawesome-solid-book-open: Practicalli ClojureScript](https://practical.li/clojurescript){target=_blank .md-button}
7679

7780

81+
<!--
7882
## Clojure Data Science
7983
8084
Clojure tools and techniques when working with data science related projects. Ingest data
@@ -99,3 +103,4 @@ Practicalli contributed Calva key bindings to the VSpaceCode project to support
99103
100104
[:fontawesome-solid-book-open: Practicalli VSpaceCode](https://practical.li/vspacecode){target=_blank .md-button}
101105
106+
-->

0 commit comments

Comments
 (0)