updated docs

Author: forman

docs/about.md

@@ -56,8 +56,8 @@ Chartlets' TypeScript code is formatted by
 [prettier](https://prettier.io/).
 
 ```bash
-cd chartlets.js
-prettier .
+cd chartlets.js/packages/lib
+prettier -w .
 ```
 
 ### Documentation

docs/demo.md

@@ -1,24 +1,59 @@
 Chartlets provides a simple demo that serves as a
 reference for the framework usage and testbed for its features.
 
+The following steps assume the latest versions of the following 
+development tools are installed:
+
+- `git`
+- `conda` or `mamba`
+- `npm` from `node.js` 
+
+## Get sources from repo
+
 ```bash
 git clone https://github.com/bcdev/chartlets.git
 ```
 
-### Run the server
+This will create the folder `chartlets` which is referred to as
+`${project}` in the following.
+
+## Run demo server
+
+Create environment and install library
 
 ```bash
-cd chartlets/chartlets.py
+cd ${project}/chartlets.py
 conda env create
 conda activate chartlets
 pip install -ve . 
-python -m chartlets.demo.server
 ```
 
-### Run the UI
+Run demo server
+
+```bash
+cd ${project}/chartlets.py/demo
+python -m server.main 
+```
+
+## Run demo UI
+
+Install common dependencies
 
 ```bash
-cd ../chartlets.js
+cd ${project}/chartlets.js
 npm install
+```
+
+Build the library
+
+```bash
+cd ${project}/chartlets.js/packages/lib
+npm run build
+```
+
+Run the demo UI
+
+```bash
+cd ${project}/chartlets.js/packages/demo
 npm run dev
-```
+```

docs/guide/contributors.md

@@ -9,7 +9,7 @@ Your module is supposed to export one or more instances of the
 `chartlets.Extension` class. An extension object is a container for your
 UI contributions. It groups contributions that logically belong together.
 
-As an example, see [`my_extension` of the demo](https://github.com/bcdev/chartlets/tree/main/chartlets.py/my_extension).
+As an example, see [`my_extension` of the demo](https://github.com/bcdev/chartlets/tree/main/chartlets.py/demo/my_extension).
 
 To develop an extension, follow these steps:
 
@@ -35,11 +35,12 @@ ext = Extension("my_dashboard")
 ## Create the contribution object
 
 In a submodule you create a contribution object from an application specific
-contribution, e.g., a `Panel`. Application-specific contribution classes 
-are always derived from `chartlets.Contribution`.
+contribution, e.g., a `Panel` from the Chartlets demo server. 
+Application-specific contribution classes are always derived from
+`chartlets.Contribution`.
 
 ```python
-from chartlets.demo import Panel
+from server.contribs import Panel
 
 panel = Panel(title="Click Statistics")
 ```

docs/guide/providers.md

@@ -54,7 +54,7 @@ Currently, Chartlets is available from PyPI only.
 Implement the application-specific contributions that users 
 can add to their extensions.
 
-As an example, see [`panel.py` of the demo](https://github.com/bcdev/chartlets/tree/main/chartlets.py/chartlets/demo/contribs/panel.py):
+As an example, see [`panel.py` of the demo](https://github.com/bcdev/chartlets/tree/main/chartlets.py/demo/server/contribs/panel.py):
 
 ```python
 from chartlets import Contribution
@@ -71,11 +71,11 @@ class Panel(Contribution):
 
 Define the possible contribution points in your application.
 
-As an example, see [`server.py` of the demo](https://github.com/bcdev/chartlets/tree/main/chartlets.py/chartlets/demo/server.py):
+As an example, see [`server.py` of the demo](https://github.com/bcdev/chartlets/tree/main/chartlets.py/demo/server/server.py):
 
 ```python
 from chartlets import Extension
-from chartlets.demo.contribs import Panel
+from .contribs import Panel
 
 Extension.add_contrib_point("panels", Panel)
 ```
@@ -84,7 +84,7 @@ Extension.add_contrib_point("panels", Panel)
 
 Load the extensions that augment your application.
 
-As an example, see [`server.py` of the demo](https://github.com/bcdev/chartlets/tree/main/chartlets.py/chartlets/demo/server.py):
+As an example, see [`server.py` of the demo](https://github.com/bcdev/chartlets/tree/main/chartlets.py/demo/server/server.py):
 
 ```python
 from chartlets import ExtensionContext
@@ -97,15 +97,15 @@ ext_ctx = ExtensionContext.load(app_ctx, extension_refs)
 Implement the Chartlets API in your application-specific webserver using
 the controller implementations in `chartlets.controllers`. 
 
-As an example, see [`server.py` of the demo](https://github.com/bcdev/chartlets/tree/main/chartlets.py/chartlets/demo/server.py).
+As an example, see [`server.py` of the demo](https://github.com/bcdev/chartlets/tree/main/chartlets.py/demo/server/server.py).
 
 ## Frontend integration
 
 The JavaScript package `chartlets` provides the types, actions, and hooks
 to allow for supporting server-side UI contributions in your React 
 application. 
 
-As an example, see [the demo application](https://github.com/bcdev/chartlets/tree/main/chartlets.js/src/demo).
+As an example, see [the demo application](https://github.com/bcdev/chartlets/tree/main/chartlets.js/packages/demo/src).
 
 As an application provider you will need to perform the 
 following steps: