docs: add build and publish guides

Author: ngfelixl

README.md

@@ -46,6 +46,37 @@ set "NODEPLOTLIB_PORT=4201" && npx nx run dev-server:serve
 $env:NODEPLOTLIB_PORT = "4201" ; npx nx run dev-server:serve
 ```
 
+## Build for production
+
+To build for production three steps are necessary. Build the web app, build
+the library, and finally copy the web app files to the libraries dist folder.
+All steps are bundled in the following script:
+
+```
+npm run build:prod
+```
+
+All dist files are located in **/dist/libs/nodeplotlib**
+
+## Release Guide
+
+This is a note for maintainers only. There are several steps to follow before you
+can publish the new version to npm.
+
+1. Bump the version number using semver. Use "rc" for release candidates as the _preid_, e.g.
+   `1.0.0-rc1`. Updat the version number in the root [package.json](./package.json)
+   and in the libs [package.json](./libs/nodeplotlib/package.json).
+2. If everything is committed and in place on "master" for non-release candidates,
+   or on "release/..." for release candidates. Create a tag with that version number,
+   e.g. `v1.0.0-rc1` or `v1.0.1`, and push it to the repository.
+3. Run `npm run build:prod`
+4. Navigate to **/dist/libs/nodeplotlib**
+5. Run `npm pack`
+6. Make sure to be logged in to npmjs. Then run
+   - `npm publish {{filename}}.tgz` or
+   - `npm publish {{filename}}.tgz --tag test` for release candidates.
+7. Create a release on Github for non-release cadidate versions.
+
 ## Behind the scenes
 
 The lib launches a webserver and opens new tabs for every plot located at

libs/nodeplotlib/README.md

@@ -27,11 +27,13 @@ Use with TypeScript/JavaScript:
 ```typescript
 import { plot, Plot } from 'nodeplotlib';
 
-const data: Plot[] = [{
+const data: Plot[] = [
+  {
     x: [1, 3, 4, 5],
     y: [3, 12, 1, 4],
     type: 'scatter',
-}];
+  },
+];
 
 plot(data);
 ```
@@ -55,13 +57,15 @@ const stream$: Observable<Plot[]> = interval(100).pipe(
 );
 
 function createSinusPlotFromNumber(num: number): Plot[] {
-  const data: Plot[] = [{
-    x: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9],
-    y: Array(10)
-      .fill(0)
-      .map((_, i) => Math.sin(num + i)),
-    type: 'scatter',
-  }];
+  const data: Plot[] = [
+    {
+      x: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9],
+      y: Array(10)
+        .fill(0)
+        .map((_, i) => Math.sin(num + i)),
+      type: 'scatter',
+    },
+  ];
   return data;
 }
 ```