docs: move and adapt the other chapters of Stan's docs suitable for public docs

also added `just serve-docs`

Author: alehander92

.gitignore

@@ -11,7 +11,7 @@ build-*/
 .direnv/
 result
 
-docs/experimental-documentation/build/*
+docs/book/book
 src/index.js
 ui.js
 debugger.js

ci/deploy/docs.sh

@@ -2,7 +2,7 @@
 
 set -e
 
-pushd docs/experimental-documentation/mdbook-ct
+pushd docs/book/
 
 # TODO: eventually: a more fine-grained nix shell/env?
 # nix-shell --command "mdbook build"

docs/experimental-documentation/.htaccess docs/book/.htaccessdocs/experimental-documentation/.htaccess renamed to docs/book/.htaccess

@@ -0,0 +1,36 @@
+## Summary
+
+- [Introduction](./introduction.md)
+
+## Usage guide
+
+- [Intro to usage guide](./usage_guide/intro_to_usage.md)
+- [CLI](./usage_guide/CLI.md)
+- [Basic GUI](./usage_guide/basic_gui.md)
+- [Tracepoints](./usage_guide/tracepoints.md)
+- [CodeTracer Shell](./usage_guide/codetracer_shell.md)
+
+## Backends
+
+- [DB backend](./backends/db_backend.md)
+  - [Noir](./backends/db-backend/noir.md)
+  - [Ruby](./backends/db-backend/ruby.md)
+  - [Python](./backends/db-backend/py.md)
+  - [Lua](./backends/db-backend/lua.md)
+  - [small](./backends/db-backend/small.md)
+  
+- [RR backend](./backends/rr_backend.md)
+  - [C & C++](./backends/rr-backend/c_and_cpp.md)
+  - [Rust](./backends/rr-backend/rust.md)
+  - [Nim](./backends/rr-backend/nim.md)
+  - [Go](./backends/rr-backend/go.md)
+
+## Building & packaging
+
+- [Build systems](./building_and_packaging/build_systems.md)
+
+### Misc
+
+- [Troubleshooting](./misc/troubleshooting.md)
+- [Environment variables](./misc/environment_variables.md)
+- [Building the documentation](./misc/building_docs.md)

…mental-documentation/mdbook-ct/book.toml docs/book/book.tomldocs/experimental-documentation/mdbook-ct/book.toml renamed to docs/book/book.toml docs/experimental-documentation/mdbook-ct/book.toml renamed to docs/book/book.toml

@@ -0,0 +1,5 @@
+## Lua
+
+We still don't have Lua support, however we've had a very minimal proof of concept experiment with supporting Lua (the interpreter, not LuaJIT) with our RR backend years ago.
+
+We can change that patch to produce traces suitable for the DB backend, or at least publish some kind of basis for that(the RR approach remains possible, but with different tradeoffs)

…mental-documentation/mdbook-ct/shell.nix docs/book/shell.nixdocs/experimental-documentation/mdbook-ct/shell.nix renamed to docs/book/shell.nix docs/experimental-documentation/mdbook-ct/shell.nix renamed to docs/book/shell.nix

@@ -0,0 +1,7 @@
+## Noir
+
+The initial release of CodeTracer has MVP support for the Noir programming language. It has been developed in collaboration with the Blocksense team and currently requires the use of the [Blocksense Noir Compiler](https://github.com/blocksense-network/noir), which is included in the CodeTracer distribution.
+
+We support many of Noir's features, but not all: e.g. we don't support mutable references currently, we don't serialize struct values and some other cases.
+
+We are planning on adding support for the missing features.

docs/book/src/SUMMARY.md

@@ -0,0 +1,8 @@
+## python
+
+We currently have started adding support for recording python programs for the DB backend, but the prototype isn't finished yet. 
+
+The recorder is currently hosted in the [codetracer-python-recorder](https://github.com/metacraft-labs/codetracer-python-recorder) repo.
+
+You can read its README for more details. We are welcoming contributors!
+

docs/book/src/backends/db-backend/lua.md

@@ -0,0 +1 @@
+# Python