doc: mv STYLEGUIDE to root and minor additions (style)

[ci skip]

Author: vindarel

src/doc/STYLEGUIDE.md STYLEGUIDE.md

@@ -2,7 +2,7 @@
 
 ## General
 
-* The [mito](https://quickref.common-lisp.net/mito.html) (source: [mito](https://github.com/fukamachi/mito)) Common Lisp ORM is used.
+* The [Mito](https://github.com/fukamachi/mito) ([Quickref API](https://quickref.common-lisp.net/mito.html)) Common Lisp ORM is used.
 
 ## Code overview
 
@@ -13,4 +13,3 @@
     * defines procedures: `connect`, `ensure-tables-exist`, `bootstrap-base-roles`, `initialize-database`, `migrate-all`
 
 * `authentication.lisp`, `models/{models,contacts,baskets}.lisp`: define the tables via `defclass` and mito's `mito:dao-table-mixin` metaclass. (NOTE: `mito:deftable` could be used to make definitions slightly shorter.)
-

src/doc/database.md

@@ -18,7 +18,7 @@ See also:
 * `authentication.lisp`: defines the `user`, `role`, `user-role`,
   `role-copy` classes, and associated actions, in package
   `bookshops.models`):
-  
+
     * `create-user`, `create-superuser`, `create-role`, `login` (just
       returns the user object if password is correct), `get-user`,
       `search-user` (find user by name or mail), `is-superuser`,
@@ -39,4 +39,3 @@ See also:
     * defines `render-template*` macro: used in `web/web.lisp` and `web/authentication.lisp`
 
 * `../tests/test-authentication.lisp`: tests, obviously, are more needed?
-

src/doc/permissions.md

@@ -1,8 +1,8 @@
 # Web stack
 
-* [hunchentoot](https://github.com/edicl/hunchentoot) for web serving.
-* [easy-routes](https://github.com/mmontone/easy-routes) sits on top of hunchentoot.
-* [djula](https://quickref.common-lisp.net/djula.html), a Common Lisp port of the Python Django templating engine, is used for rendering.
+* [Hunchentoot](https://github.com/edicl/hunchentoot) for web serving.
+* [Easy-routes](https://github.com/mmontone/easy-routes) sits on top of hunchentoot.
+* [Djula](https://quickref.common-lisp.net/djula.html), a Common Lisp port of the Python Django templating engine, is used for rendering.
 
 Also see [web/doc/README](../web/doc/README.md) about the currently implemented functionality.
 

src/doc/web.md

@@ -22,6 +22,10 @@ With "FEL à la demande" we can search by ISBN, and not do a free search.
 We can't get the cover nor the summary either, but we have additional information:
 
 - the availability
+- the VAT
+- the CLIL theme
+- the provider(s) (by its code)
+- and more
 
 
 # Seeing one's stock