From ddfaee6afbffacdc56ffd1a356e61af2066e2ca3 Mon Sep 17 00:00:00 2001
From: Christos Hadjiaslanis <chrishadjiaslanis@gmail.com>
Date: Tue, 21 May 2024 20:09:03 +0100
Subject: [PATCH] Restructured docs to account for operators

---
 book.toml                                     |   4 +
 linera-protocol                               |   2 +-
 src/SUMMARY.md                                |  92 +++++++++---------
 src/developers.md                             |   3 +
 src/{ => developers}/advanced_topics.md       |   0
 .../advanced_topics/assets.md                 |   0
 .../advanced_topics/block_creation.md         |   0
 .../advanced_topics/contract_finalize.md      |   0
 .../advanced_topics/persistent_storage.md     |   0
 .../advanced_topics/validators.md             |   0
 src/{ => developers}/advanced_topics/views.md |   0
 src/{ => developers}/appendix.md              |   0
 src/{ => developers}/appendix/glossary.md     |   0
 src/{ => developers}/appendix/videos.md       |   0
 src/{ => developers}/core_concepts.md         |   0
 .../core_concepts/applications.md             |   0
 .../core_concepts/graphiql.png                | Bin
 .../core_concepts/microchains.md              |   0
 .../core_concepts/node_service.md             |   0
 .../core_concepts/overview.md                 |   0
 src/{ => developers}/core_concepts/wallets.md |   0
 src/{ => developers}/experimental.md          |   0
 src/{ => developers}/experimental/ml.md       |   0
 src/{ => developers}/getting_started.md       |   0
 .../getting_started/hello_linera.md           |   2 +-
 .../getting_started/installation.md           |  12 +--
 .../images/Linera-Header_1920x284px.svg       |   0
 src/{ => developers}/sdk.md                   |   0
 src/{ => developers}/sdk/abi.md               |   6 +-
 src/{ => developers}/sdk/composition.md       |   4 +-
 src/{ => developers}/sdk/contract.md          |   2 +-
 .../sdk/creating_a_project.md                 |   0
 src/{ => developers}/sdk/deploy.md            |   2 +-
 src/{ => developers}/sdk/logging.md           |   0
 src/{ => developers}/sdk/messages.md          |   2 +-
 src/{ => developers}/sdk/service.md           |   4 +-
 src/{ => developers}/sdk/state.md             |   0
 src/{ => developers}/sdk/testing.md           |   0
 src/introduction.md                           |  18 ++--
 src/operators.md                              |   3 +
 src/operators/getting_started.md              |   0
 41 files changed, 87 insertions(+), 69 deletions(-)
 create mode 100644 src/developers.md
 rename src/{ => developers}/advanced_topics.md (100%)
 rename src/{ => developers}/advanced_topics/assets.md (100%)
 rename src/{ => developers}/advanced_topics/block_creation.md (100%)
 rename src/{ => developers}/advanced_topics/contract_finalize.md (100%)
 rename src/{ => developers}/advanced_topics/persistent_storage.md (100%)
 rename src/{ => developers}/advanced_topics/validators.md (100%)
 rename src/{ => developers}/advanced_topics/views.md (100%)
 rename src/{ => developers}/appendix.md (100%)
 rename src/{ => developers}/appendix/glossary.md (100%)
 rename src/{ => developers}/appendix/videos.md (100%)
 rename src/{ => developers}/core_concepts.md (100%)
 rename src/{ => developers}/core_concepts/applications.md (100%)
 rename src/{ => developers}/core_concepts/graphiql.png (100%)
 rename src/{ => developers}/core_concepts/microchains.md (100%)
 rename src/{ => developers}/core_concepts/node_service.md (100%)
 rename src/{ => developers}/core_concepts/overview.md (100%)
 rename src/{ => developers}/core_concepts/wallets.md (100%)
 rename src/{ => developers}/experimental.md (100%)
 rename src/{ => developers}/experimental/ml.md (100%)
 rename src/{ => developers}/getting_started.md (100%)
 rename src/{ => developers}/getting_started/hello_linera.md (99%)
 rename src/{ => developers}/getting_started/installation.md (88%)
 rename src/{ => developers}/images/Linera-Header_1920x284px.svg (100%)
 rename src/{ => developers}/sdk.md (100%)
 rename src/{ => developers}/sdk/abi.md (90%)
 rename src/{ => developers}/sdk/composition.md (96%)
 rename src/{ => developers}/sdk/contract.md (98%)
 rename src/{ => developers}/sdk/creating_a_project.md (100%)
 rename src/{ => developers}/sdk/deploy.md (97%)
 rename src/{ => developers}/sdk/logging.md (100%)
 rename src/{ => developers}/sdk/messages.md (98%)
 rename src/{ => developers}/sdk/service.md (97%)
 rename src/{ => developers}/sdk/state.md (100%)
 rename src/{ => developers}/sdk/testing.md (100%)
 create mode 100644 src/operators.md
 create mode 100644 src/operators/getting_started.md

diff --git a/book.toml b/book.toml
index 847e8852..dbb61e21 100644
--- a/book.toml
+++ b/book.toml
@@ -10,6 +10,10 @@ default-theme = "Light"
 default-dark-theme = "Ayu"
 additional-js = ["custom.js"]
 
+[output.html.fold]
+enable = true
+level = 0
+
 [output.html.playground]
 runnable = false
 
diff --git a/linera-protocol b/linera-protocol
index 1b3b46f0..518b0a6e 160000
--- a/linera-protocol
+++ b/linera-protocol
@@ -1 +1 @@
-Subproject commit 1b3b46f0cd422607ed89e919a5ac24611fba8644
+Subproject commit 518b0a6e0097dbad2f6a23f8480884abf56900ee
diff --git a/src/SUMMARY.md b/src/SUMMARY.md
index aaa1a6d1..57924a35 100644
--- a/src/SUMMARY.md
+++ b/src/SUMMARY.md
@@ -1,49 +1,53 @@
 # Summary
 
-[The Linera Developer Manual](introduction.md)
-
-- [Getting Started](getting_started.md)
-
-  - [Installation](getting_started/installation.md)
-  - [Hello, Linera](getting_started/hello_linera.md)
-
-- [The Linera Protocol](core_concepts.md)
-
-  - [Overview](core_concepts/overview.md)
-  - [Microchains](core_concepts/microchains.md)
-  - [Wallets](core_concepts/wallets.md)
-  - [Node Service](core_concepts/node_service.md)
-  - [Applications](core_concepts/applications.md)
-
-- [Writing Linera Applications](sdk.md)
-
-  - [Creating a Project](sdk/creating_a_project.md)
-  - [Creating the Application State](sdk/state.md)
-  - [Defining the ABI](sdk/abi.md)
-  - [Writing the Contract Binary](sdk/contract.md)
-  - [Writing the Service Binary](sdk/service.md)
-  - [Deploying the Application](sdk/deploy.md)
-  - [Cross-Chain Messages](sdk/messages.md)
-  - [Calling other Applications](sdk/composition.md)
-  - [Printing Logs from an Application](sdk/logging.md)
-  - [Writing Tests](sdk/testing.md)
-
-- [Advanced Topics](advanced_topics.md)
-
-  - [Views](advanced_topics/views.md)
-  - [Persistent Storage](advanced_topics/persistent_storage.md)
-  - [Contract Finalization](advanced_topics/contract_finalize.md)
-  - [Validators](advanced_topics/validators.md)
-  - [Creating New Blocks](advanced_topics/block_creation.md)
-  - [Applications that Handle Assets](advanced_topics/assets.md)
-
-- [Experimental](experimental.md)
-
-  - [Machine Learning](experimental/ml.md)
-
-- [Appendix](appendix.md)
-  - [Glossary](appendix/glossary.md)
-  - [Videos](appendix/videos.md)
+[The Linera Manual](introduction.md)
+
+- [Developers](./developers.md)
+
+  - [Getting Started](developers/getting_started.md)
+  
+      - [Installation](developers/getting_started/installation.md)
+      - [Hello, Linera](developers/getting_started/hello_linera.md)
+  
+  - [The Linera Protocol](developers/core_concepts.md)
+  
+      - [Overview](developers/core_concepts/overview.md)
+        - [Microchains](developers/core_concepts/microchains.md)
+        - [Wallets](developers/core_concepts/wallets.md)
+        - [Node Service](developers/core_concepts/node_service.md)
+        - [Applications](developers/core_concepts/applications.md)
+  
+  - [Writing Linera Applications](developers/sdk.md)
+  
+      - [Creating a Project](developers/sdk/creating_a_project.md)
+        - [Creating the Application State](developers/sdk/state.md)
+        - [Defining the ABI](developers/sdk/abi.md)
+        - [Writing the Contract Binary](developers/sdk/contract.md)
+        - [Writing the Service Binary](developers/sdk/service.md)
+        - [Deploying the Application](developers/sdk/deploy.md)
+        - [Cross-Chain Messages](developers/sdk/messages.md)
+        - [Calling other Applications](developers/sdk/composition.md)
+        - [Printing Logs from an Application](developers/sdk/logging.md)
+        - [Writing Tests](developers/sdk/testing.md)
+  
+  - [Advanced Topics](developers/advanced_topics.md)
+  
+      - [Views](developers/advanced_topics/views.md)
+        - [Persistent Storage](developers/advanced_topics/persistent_storage.md)
+        - [Contract Finalization](developers/advanced_topics/contract_finalize.md)
+        - [Validators](developers/advanced_topics/validators.md)
+        - [Creating New Blocks](developers/advanced_topics/block_creation.md)
+        - [Applications that Handle Assets](developers/advanced_topics/assets.md)
+  
+  - [Experimental](developers/experimental.md)
+  
+      - [Machine Learning](developers/experimental/ml.md)
+  
+  - [Appendix](developers/appendix.md)
+      - [Glossary](developers/appendix/glossary.md)
+      - [Videos](developers/appendix/videos.md)
+
+- [Operators](operators.md)
 
 <!-- prettier-ignore-start -->
 <!--
diff --git a/src/developers.md b/src/developers.md
new file mode 100644
index 00000000..e5c4cfce
--- /dev/null
+++ b/src/developers.md
@@ -0,0 +1,3 @@
+# Developer Manual
+
+This section of the Linera Manual is for developers building applications on Linera.
\ No newline at end of file
diff --git a/src/advanced_topics.md b/src/developers/advanced_topics.md
similarity index 100%
rename from src/advanced_topics.md
rename to src/developers/advanced_topics.md
diff --git a/src/advanced_topics/assets.md b/src/developers/advanced_topics/assets.md
similarity index 100%
rename from src/advanced_topics/assets.md
rename to src/developers/advanced_topics/assets.md
diff --git a/src/advanced_topics/block_creation.md b/src/developers/advanced_topics/block_creation.md
similarity index 100%
rename from src/advanced_topics/block_creation.md
rename to src/developers/advanced_topics/block_creation.md
diff --git a/src/advanced_topics/contract_finalize.md b/src/developers/advanced_topics/contract_finalize.md
similarity index 100%
rename from src/advanced_topics/contract_finalize.md
rename to src/developers/advanced_topics/contract_finalize.md
diff --git a/src/advanced_topics/persistent_storage.md b/src/developers/advanced_topics/persistent_storage.md
similarity index 100%
rename from src/advanced_topics/persistent_storage.md
rename to src/developers/advanced_topics/persistent_storage.md
diff --git a/src/advanced_topics/validators.md b/src/developers/advanced_topics/validators.md
similarity index 100%
rename from src/advanced_topics/validators.md
rename to src/developers/advanced_topics/validators.md
diff --git a/src/advanced_topics/views.md b/src/developers/advanced_topics/views.md
similarity index 100%
rename from src/advanced_topics/views.md
rename to src/developers/advanced_topics/views.md
diff --git a/src/appendix.md b/src/developers/appendix.md
similarity index 100%
rename from src/appendix.md
rename to src/developers/appendix.md
diff --git a/src/appendix/glossary.md b/src/developers/appendix/glossary.md
similarity index 100%
rename from src/appendix/glossary.md
rename to src/developers/appendix/glossary.md
diff --git a/src/appendix/videos.md b/src/developers/appendix/videos.md
similarity index 100%
rename from src/appendix/videos.md
rename to src/developers/appendix/videos.md
diff --git a/src/core_concepts.md b/src/developers/core_concepts.md
similarity index 100%
rename from src/core_concepts.md
rename to src/developers/core_concepts.md
diff --git a/src/core_concepts/applications.md b/src/developers/core_concepts/applications.md
similarity index 100%
rename from src/core_concepts/applications.md
rename to src/developers/core_concepts/applications.md
diff --git a/src/core_concepts/graphiql.png b/src/developers/core_concepts/graphiql.png
similarity index 100%
rename from src/core_concepts/graphiql.png
rename to src/developers/core_concepts/graphiql.png
diff --git a/src/core_concepts/microchains.md b/src/developers/core_concepts/microchains.md
similarity index 100%
rename from src/core_concepts/microchains.md
rename to src/developers/core_concepts/microchains.md
diff --git a/src/core_concepts/node_service.md b/src/developers/core_concepts/node_service.md
similarity index 100%
rename from src/core_concepts/node_service.md
rename to src/developers/core_concepts/node_service.md
diff --git a/src/core_concepts/overview.md b/src/developers/core_concepts/overview.md
similarity index 100%
rename from src/core_concepts/overview.md
rename to src/developers/core_concepts/overview.md
diff --git a/src/core_concepts/wallets.md b/src/developers/core_concepts/wallets.md
similarity index 100%
rename from src/core_concepts/wallets.md
rename to src/developers/core_concepts/wallets.md
diff --git a/src/experimental.md b/src/developers/experimental.md
similarity index 100%
rename from src/experimental.md
rename to src/developers/experimental.md
diff --git a/src/experimental/ml.md b/src/developers/experimental/ml.md
similarity index 100%
rename from src/experimental/ml.md
rename to src/developers/experimental/ml.md
diff --git a/src/getting_started.md b/src/developers/getting_started.md
similarity index 100%
rename from src/getting_started.md
rename to src/developers/getting_started.md
diff --git a/src/getting_started/hello_linera.md b/src/developers/getting_started/hello_linera.md
similarity index 99%
rename from src/getting_started/hello_linera.md
rename to src/developers/getting_started/hello_linera.md
index 0001f882..ff3e753d 100644
--- a/src/getting_started/hello_linera.md
+++ b/src/developers/getting_started/hello_linera.md
@@ -18,7 +18,7 @@ available to create new microchains and obtain some test tokens. To do so, this
 must be configured when initializing the wallet:
 
 ```bash
-linera wallet init --with-new-chain --faucet https://faucet.{{#include ../../RELEASE_DOMAIN}}.linera.net
+linera wallet init --with-new-chain --faucet https://faucet.{{#include ../../../RELEASE_DOMAIN}}.linera.net
 ```
 
 This creates a new microchain on Devnet with some initial test tokens, and the
diff --git a/src/getting_started/installation.md b/src/developers/getting_started/installation.md
similarity index 88%
rename from src/getting_started/installation.md
rename to src/developers/getting_started/installation.md
index 59734f82..3d20975f 100644
--- a/src/getting_started/installation.md
+++ b/src/developers/getting_started/installation.md
@@ -50,7 +50,7 @@ protocol itself, see the installation section on
 This manual was tested with the following Rust toolchain:
 
 ```text
-{{#include ../../linera-protocol/rust-toolchain.toml}}
+{{#include ../../../linera-protocol/rust-toolchain.toml}}
 ```
 
 ## Installing from crates.io
@@ -58,16 +58,16 @@ This manual was tested with the following Rust toolchain:
 You may install the Linera binaries with
 
 ```bash
-cargo install --locked linera-service@{{#include ../../RELEASE_VERSION}}
+cargo install --locked linera-service@{{#include ../../../RELEASE_VERSION}}
 ```
 
 and use `linera-sdk` as a library for Linera Wasm applications:
 
 ```bash
-cargo add linera-sdk@{{#include ../../RELEASE_VERSION}}
+cargo add linera-sdk@{{#include ../../../RELEASE_VERSION}}
 ```
 
-The version number `{{#include ../../RELEASE_VERSION}}` corresponds to the
+The version number `{{#include ../../../RELEASE_VERSION}}` corresponds to the
 current Devnet of Linera and may change frequently.
 
 ## Installing from GitHub
@@ -77,7 +77,7 @@ Download the source from [GitHub](https://github.com/linera-io/linera-protocol):
 ```bash
 git clone https://github.com/linera-io/linera-protocol.git
 cd linera-protocol
-git checkout -t origin/{{#include ../../RELEASE_BRANCH}}  # Current release branch
+git checkout -t origin/{{#include ../../../RELEASE_BRANCH}}  # Current release branch
 ```
 
 To install the Linera toolchain locally from source, you may run:
@@ -93,7 +93,7 @@ This manual was tested against the following commit of the
 [repository](https://github.com/linera-io/linera-protocol):
 
 ```text
-{{#include ../../.git/modules/linera-protocol/HEAD}}
+{{#include ../../../.git/modules/linera-protocol/HEAD}}
 ```
 
 ## Bash helper (optional)
diff --git a/src/images/Linera-Header_1920x284px.svg b/src/developers/images/Linera-Header_1920x284px.svg
similarity index 100%
rename from src/images/Linera-Header_1920x284px.svg
rename to src/developers/images/Linera-Header_1920x284px.svg
diff --git a/src/sdk.md b/src/developers/sdk.md
similarity index 100%
rename from src/sdk.md
rename to src/developers/sdk.md
diff --git a/src/sdk/abi.md b/src/developers/sdk/abi.md
similarity index 90%
rename from src/sdk/abi.md
rename to src/developers/sdk/abi.md
index c651be1e..c254d6d4 100644
--- a/src/sdk/abi.md
+++ b/src/developers/sdk/abi.md
@@ -24,7 +24,7 @@ The `Abi` trait combines the `ContractAbi` and `ServiceAbi` traits to include
 the types that your application exports.
 
 ```rust,ignore
-{{#include ../../linera-protocol/linera-base/src/abi.rs:abi}}
+{{#include ../../../linera-protocol/linera-base/src/abi.rs:abi}}
 ```
 
 Next, we're going to implement each of the two traits.
@@ -35,7 +35,7 @@ The `ContractAbi` trait defines the data types that your application uses in a
 contract. Each type represents a specific part of the contract's behavior:
 
 ```rust,ignore
-{{#include ../../linera-protocol/linera-base/src/abi.rs:contract_abi}}
+{{#include ../../../linera-protocol/linera-base/src/abi.rs:contract_abi}}
 ```
 
 All these types must implement the `Serialize`, `DeserializeOwned`, `Send`,
@@ -62,7 +62,7 @@ The `ServiceAbi` trait defines the types used by the service part of your
 application:
 
 ```rust,ignore
-{{#include ../../linera-protocol/linera-base/src/abi.rs:service_abi}}
+{{#include ../../../linera-protocol/linera-base/src/abi.rs:service_abi}}
 ```
 
 For our Counter example, we'll be using GraphQL to query our application so our
diff --git a/src/sdk/composition.md b/src/developers/sdk/composition.md
similarity index 96%
rename from src/sdk/composition.md
rename to src/developers/sdk/composition.md
index 5298814b..7cd992cb 100644
--- a/src/sdk/composition.md
+++ b/src/developers/sdk/composition.md
@@ -96,8 +96,8 @@ tokens.
 
 For the complete code please take a look at the
 [`crowd-funding`](https://github.com/linera-io/linera-protocol/blob/{{#include
-../../.git/modules/linera-protocol/HEAD}}/examples/crowd-funding/src/contract.rs)
+../../../.git/modules/linera-protocol/HEAD}}/examples/crowd-funding/src/contract.rs)
 and the
 [`fungible`](https://github.com/linera-io/linera-protocol/blob/{{#include
-../../.git/modules/linera-protocol/HEAD}}/examples/fungible/src/contract.rs)
+../../../.git/modules/linera-protocol/HEAD}}/examples/fungible/src/contract.rs)
 application contracts in the `examples` folder in `linera-protocol`.
diff --git a/src/sdk/contract.md b/src/developers/sdk/contract.md
similarity index 98%
rename from src/sdk/contract.md
rename to src/developers/sdk/contract.md
index adc89292..acd316b8 100644
--- a/src/sdk/contract.md
+++ b/src/developers/sdk/contract.md
@@ -37,7 +37,7 @@ pub trait Contract: WithContractAbi + ContractAbi + Sized {
 
 The full trait definition can be found
 [here](https://github.com/linera-io/linera-protocol/blob/{{#include
-../../.git/modules/linera-protocol/HEAD}}/linera-sdk/src/lib.rs).
+../../../.git/modules/linera-protocol/HEAD}}/linera-sdk/src/lib.rs).
 
 There's quite a bit going on here, so let's break it down and take one method at
 a time.
diff --git a/src/sdk/creating_a_project.md b/src/developers/sdk/creating_a_project.md
similarity index 100%
rename from src/sdk/creating_a_project.md
rename to src/developers/sdk/creating_a_project.md
diff --git a/src/sdk/deploy.md b/src/developers/sdk/deploy.md
similarity index 97%
rename from src/sdk/deploy.md
rename to src/developers/sdk/deploy.md
index 1c543d41..deceb6c1 100644
--- a/src/sdk/deploy.md
+++ b/src/developers/sdk/deploy.md
@@ -29,7 +29,7 @@ To configure the wallet for the devnet while creating a new microchain, the
 following command can be used:
 
 ```bash
-linera wallet init --with-new-chain --faucet https://faucet.{{#include ../../RELEASE_DOMAIN}}.linera.net
+linera wallet init --with-new-chain --faucet https://faucet.{{#include ../../../RELEASE_DOMAIN}}.linera.net
 ```
 
 The Faucet will provide the new chain with some tokens, which can then be used
diff --git a/src/sdk/logging.md b/src/developers/sdk/logging.md
similarity index 100%
rename from src/sdk/logging.md
rename to src/developers/sdk/logging.md
diff --git a/src/sdk/messages.md b/src/developers/sdk/messages.md
similarity index 98%
rename from src/sdk/messages.md
rename to src/developers/sdk/messages.md
index 2925f1c0..5c1f4c79 100644
--- a/src/sdk/messages.md
+++ b/src/developers/sdk/messages.md
@@ -55,7 +55,7 @@ receiver rejects it. The example below enables both flags:
 
 In the [`fungible` example
 application](https://github.com/linera-io/linera-protocol/tree/{{#include
-../../.git/modules/linera-protocol/HEAD}}/examples/fungible), such a message can
+../../../.git/modules/linera-protocol/HEAD}}/examples/fungible), such a message can
 be the transfer of tokens from one chain to another. If the sender includes a
 `Transfer` operation on their chain, it decreases their account balance and
 sends a `Credit` message to the recipient's chain:
diff --git a/src/sdk/service.md b/src/developers/sdk/service.md
similarity index 97%
rename from src/sdk/service.md
rename to src/developers/sdk/service.md
index 72a90e6f..1ae5cc01 100644
--- a/src/sdk/service.md
+++ b/src/developers/sdk/service.md
@@ -28,7 +28,7 @@ pub trait Service: WithServiceAbi + ServiceAbi + Sized {
 
 The full service trait definition can be found
 [here](https://github.com/linera-io/linera-protocol/blob/{{#include
-../../.git/modules/linera-protocol/HEAD}}/linera-sdk/src/lib.rs).
+../../../.git/modules/linera-protocol/HEAD}}/linera-sdk/src/lib.rs).
 
 Let's implement `Service` for our counter application.
 
@@ -153,5 +153,5 @@ We haven't included the imports in the above code; they are left as an exercise
 to the reader (but remember to import `async_graphql::Object`). If you want the
 full source code and associated tests check out the [examples
 section](https://github.com/linera-io/linera-protocol/blob/{{#include
-../../.git/modules/linera-protocol/HEAD}}/examples/counter/src/service.rs) on
+../../../.git/modules/linera-protocol/HEAD}}/examples/counter/src/service.rs) on
 GitHub.
diff --git a/src/sdk/state.md b/src/developers/sdk/state.md
similarity index 100%
rename from src/sdk/state.md
rename to src/developers/sdk/state.md
diff --git a/src/sdk/testing.md b/src/developers/sdk/testing.md
similarity index 100%
rename from src/sdk/testing.md
rename to src/developers/sdk/testing.md
diff --git a/src/introduction.md b/src/introduction.md
index cfb47891..093777c7 100644
--- a/src/introduction.md
+++ b/src/introduction.md
@@ -1,20 +1,24 @@
-![The Linera banner](images/Linera-Header_1920x284px.svg)
+![The Linera banner](developers/images/Linera-Header_1920x284px.svg)
 
-# The Linera Developer Manual
+# The Linera Manual
 
-Welcome to the developer manual of Linera, a decentralized protocol designed for
+Welcome to the Linera manual, a decentralized protocol designed for
 **highly scalable, low-latency Web3 applications**.
 
-This documentation is intended for developers who wish to learn more about
+The documentation is split in two parts: 
+1. The [Developers](./operators.md) section
+is intended for developers who wish to learn more about
 Linera and its programming model by prototyping applications on top of the
-Linera Rust SDK.
+Linera Rust SDK. 
+2. The [Operators](./operators.md) section is intended for operators
+who wish to run Linera validators.
 
 > **NEW: Publish and test your Web3 application on the Linera Devnet!**
 >
 > Install
-> [the Linera CLI tool](getting_started/installation.html#installing-from-cratesio)
+> [the Linera CLI tool](developers/getting_started/installation.html#installing-from-cratesio)
 > then follow the instructions on
-> [this page](getting_started/hello_linera.html#using-the-devnet) to claim a
+> [this page](developers/getting_started/hello_linera.html#using-the-devnet) to claim a
 > microchain and publish your first application on the current Devnet.
 
 To join our community and get involved in the development of the Linera
diff --git a/src/operators.md b/src/operators.md
new file mode 100644
index 00000000..e8a50ecb
--- /dev/null
+++ b/src/operators.md
@@ -0,0 +1,3 @@
+# Operator Manual
+
+This section of the Linera Manual is for operators running Linera validators.
\ No newline at end of file
diff --git a/src/operators/getting_started.md b/src/operators/getting_started.md
new file mode 100644
index 00000000..e69de29b