docs update

Author: forman

CHANGES.md

@@ -0,0 +1,3 @@
+## Version 0.0.16 (from 2024/11/12)
+
+Initial, still experimental version. 

docs/about.md

@@ -0,0 +1,89 @@
+## Changes
+
+You can find the complete Chartlets changelog 
+[here](https://github.com/bcdev/chartlets/blob/main/CHANGES.md). 
+
+## Reporting
+
+If you have suggestions, ideas, feature requests, or if you have identified
+a malfunction or error, then please 
+[post an issue](https://github.com/bcdev/chartlets/issues). 
+
+## Contributions
+
+The Chartlets project welcomes contributions of any form
+as long as you respect our 
+[code of conduct](https://github.com/bcdev/chartlets/blob/main/CODE_OF_CONDUCT.md)
+and follow our 
+[contribution guide](https://github.com/bcdev/chartlets/blob/main/CONTRIBUTING.md).
+
+If you'd like to submit code or documentation changes, we ask you to provide a 
+pull request (PR) 
+[here](https://github.com/bcdev/chartlets/pulls). 
+For code and configuration changes, your PR must be linked to a 
+corresponding issue. 
+
+## Development
+
+To set up the Python development environment, with repository root as 
+current working directory:
+
+```bash
+cd chartlets.py
+pip install .[dev,doc]
+```
+
+### Testing and Coverage
+
+Chartlets uses [pytest](https://docs.pytest.org/) for unit-level testing 
+and coverage analysis for its Python code.
+
+```bash
+cd chartlets.py
+pytest --cov=chartlets tests
+```
+
+### Coding Style
+
+Chartlets' Python code is formatted by [black](https://black.readthedocs.io/).
+
+```bash
+cd chartlets.py
+black .
+```
+
+Chartlets' TypeScript code is formatted by 
+[prettier](https://prettier.io/).
+
+```bash
+cd chartlets.js
+prettier .
+```
+
+### Documentation
+
+Chartlets' documentation is built using the [mkdocs](https://www.mkdocs.org/) tool.
+
+```bash
+cd chartlets.py
+pip install .[doc]
+cd ..
+```
+
+With repository root as current working directory:
+
+```bash
+# Write
+mkdocs serve
+
+# Publish
+mkdocs build
+mkdocs gh-deploy
+```
+
+## License
+
+Chartlets is open source made available under the terms and conditions of the 
+[MIT License](https://github.com/bcdev/chartlets/blob/main/LICENSE).
+
+Copyright © 2024 Brockmann Consult Development

docs/index.md

@@ -4,6 +4,18 @@ Chartlets is a software framework that allows websites developed with
 React to be extended by server-side widgets programmed in Python or other
 programming languages. 
 
+It comprises a 
+[Python backend package](https://github.com/bcdev/chartlets/tree/main/chartlets.py)
+and a 
+[JavaScript/React frontend package](https://github.com/bcdev/chartlets/tree/main/chartlets.js).
+
+## Features
+
+- Enhance your React web application by UI-contributions programmed in Python
+- Enhance your (Python) web API to serve server-side UI-contributions.
+- Uses [Material UI](https://mui.com/material-ui/) components and 
+  [Vega-Lite](https://vega.github.io/vega-lite/) charts.
+
 ## How it works
 
 Users write the widgets in, e.g. Python, and a REST server implements three 

docs/usage.md

@@ -1,8 +1,10 @@
-The Chartlets framework has two types of users. 
+The Chartlets framework has two types of users:
 
-- **Application contributors** develop new contributions for a specific web application.
-- **Application providers** develop the web application and the service that allows
-  for server-side UI contributions.
+- **Application contributors** develop new contributions 
+  for a specific web application that is powered by Chartlets.
+- **Application providers** develop the web application 
+  and the service that allows for server-side UI contributions
+  using Chartlets.
 
 
 ## Application contributor guide