move from scripts/shaynefletcher (#1757)

Summary:
Pull Request resolved: #1757

moving the hyperactor mesh book into fbcode/monarch/docs/source/books. at this point there's enough structured material (host/agent walkthrough, bootstrapping) that it should live with the rest of monarch docs instead of in my personal scratch space.

this makes it discoverable for people who are trying to understand v1 and we can start iterating on it in-tree with normal review procedures rather than out-of-band.

Reviewed By: mariusae

Differential Revision: D86309851

fbshipit-source-id: 33a475c3ad00810d72fb18400bf89bda651698ce

Author: shayne-fletcher

docs/source/books/hyperactor-mesh-book/README.md

@@ -0,0 +1,63 @@
+# Hyperactor-mesh Book
+
+This is the development documentation for hyperactor-mesh, built using [`mdBook`](https://rust-lang.github.io/mdBook/).
+
+## Running the Book
+
+### On the **Server**
+
+To run the book on a remote server (e.g., `devgpu004`):
+
+```bash
+x2ssh devgpu004.rva5.facebook.com
+tmux new -s hyperactor-mesh-mdbook
+cd ~/fbsource/fbcode/scripts/shaynefletcher/hyperactor-mesh-book
+mdbook serve --port 3001
+```
+Then detach with Ctrl+b, then d.
+
+### On the **Client**
+
+To access the remote book from your local browser:
+```bash
+autossh -M 0 -N -L 3001:localhost:3001 devgpu004.rva5.facebook.com
+```
+Then open http://localhost:3001 in your browser.
+
+**Note**: If you don’t have autossh installed, you can install it with:
+```bash
+brew install autossh
+```
+
+### Notes
+
+- The source is located in src/, with structure defined in SUMMARY.md.
+- The book will auto-reload in the browser on edits.
+
+## Cleaning Up
+
+To shut down the book server:
+
+### Option 1: Reattach and stop
+
+```bash
+x2ssh devgpu004.rva5.facebook.com
+tmux attach -t hyperactor-mesh-mdbook
+```
+Inside the session:
+- Press Ctrl+C to stop mdbook serve
+- Then type exit to close the shell and terminate the tmux session
+
+### Option 2: Kill the session directly
+
+If you don’t want to reattach, you can kill the session from a new shell:
+```bash
+x2ssh devgpu004.rva5.facebook.com
+tmux kill-session -t hyperactor-mesh-mdbook
+```
+
+### Optional: View active tmux sessions
+```bash
+tmux ls
+```
+Use this to check whether the mdbook session is still running.

docs/source/books/hyperactor-mesh-book/book.toml

@@ -0,0 +1,5 @@
+[book]
+authors = ["Shayne Fletcher"]
+language = "en"
+src = "src"
+title = "Hyperactor-mesh Book"

docs/source/books/hyperactor-mesh-book/src/SUMMARY.md

@@ -0,0 +1,23 @@
+# Summary
+
+- [Meshes](meshes/index.md)
+  - [Bootstrapping Overview](meshes/bootstrapping-overview.md)
+      - [1. Proc and instance](meshes/bootstrapping-proc-and-instance.md)
+      - [2. Process allocator & v0 bootstrap](meshes/bootstrapping-process-allocator.md)
+      - [3. HostMesh from an allocation](meshes/bootstrapping-hostmesh-from-allocation.md)
+      - [4. Doing real work (hosts → procs → actors)](meshes/bootstrapping-doing-real-work.md)
+      - [Boostrapping from Python](meshes/bootstrapping-from-python.md)
+  - [Host & agents (control plane & mux)](meshes/host-and-agents.md)
+  - [Process-backed hosts: BootstrapProcManager](meshes/bootstrap-proc-manager.md)
+  - [Appendix: `bootstrap_canonical_simple`](meshes/bootstrapping-appendix-canonical-test.md)
+  - [Appendix: pytokio (Python/Rust async bridge)](meshes/pytokio-appendix.md)
+- [Logging](logging/index.md)
+  - [Logging Overview](logging/overview.md)
+  - [Forwarders](logging/forwarder.md)
+  - [Stream Forwarders](logging/stream-forwarders.md)
+  - [Client](logging/client.md)
+  - [Python](logging/python.md)
+  - [Config](logging/config.md)
+  - [Ordering](logging/ordering.md)
+  - [Teardown](logging/teardown.md)
+  - [File aggregation](logging/file-aggregation.md)