This is an automated email from the ASF dual-hosted git repository.
erose pushed a commit to branch HDDS-9225-website-v2
in repository https://gitbox.apache.org/repos/asf/ozone-site.git
The following commit(s) were added to refs/heads/HDDS-9225-website-v2 by this
push:
new 6007b2f6 HDDS-9865. Add outline of docs sections and pages. (#53)
6007b2f6 is described below
commit 6007b2f6ba3bbce41b2fdd15dec4ad4702890fb4
Author: Ethan Rose <[email protected]>
AuthorDate: Thu Jan 18 13:58:59 2024 -0800
HDDS-9865. Add outline of docs sections and pages. (#53)
---
README.md | 2 +-
docs/01-overview.md | 2 +-
docs/02-quick-start/01-installation/01-docker.md | 7 +++++
.../01-installation/02-kubernetes.md | 7 +++++
.../01-installation/03-bare-metal.md | 7 +++++
docs/02-quick-start/01-installation/_category_.yml | 1 +
docs/02-quick-start/02-reading-writing-data.md | 3 ++
docs/02-quick-start/_category_.yml | 1 +
docs/03-core-concepts/01-architecture.md | 6 ++++
.../02-replication/01-storage-containers.md | 6 ++++
.../02-replication/02-write-pipelines.md | 6 ++++
docs/03-core-concepts/02-replication/03-ratis.md | 3 ++
.../02-replication/04-erasure-coding.md | 3 ++
.../03-core-concepts/02-replication/_category_.yml | 1 +
docs/03-core-concepts/03-namespace/01-overview.md | 7 +++++
.../03-namespace/01-volumes/01-overview.md | 7 +++++
.../03-namespace/01-volumes/02-owners.md | 7 +++++
.../03-namespace/01-volumes/03-quotas.md | 7 +++++
.../03-namespace/01-volumes/_category_.yml | 1 +
.../03-namespace/02-buckets/01-overview.md | 7 +++++
.../03-namespace/02-buckets/02-owners.md | 7 +++++
.../03-namespace/02-buckets/03-quotas.md | 7 +++++
.../02-buckets/04-layouts/01-object-store.md | 7 +++++
.../04-layouts/02-file-system-optimized.md | 7 +++++
.../02-buckets/04-layouts/_category_.yml | 1 +
.../03-namespace/02-buckets/05-replication.md | 7 +++++
.../03-namespace/02-buckets/06-encryption.md | 7 +++++
.../03-namespace/02-buckets/07-links.md | 7 +++++
.../03-namespace/02-buckets/_category_.yml | 1 +
docs/03-core-concepts/03-namespace/_category_.yml | 1 +
.../04-security/01-authentication/01-kerberos.md | 10 ++++++
.../04-security/01-authentication/02-knox.md | 8 +++++
.../01-authentication/03-s3-credentials.md | 8 +++++
.../04-security/01-authentication/_category_.yml | 1 +
.../04-security/02-authorization/01-native-acls.md | 3 ++
.../04-security/02-authorization/02-ranger-acls.md | 3 ++
.../04-security/02-authorization/_category_.yml | 1 +
docs/03-core-concepts/04-security/_category_.yml | 1 +
docs/03-core-concepts/05-configuration-files.md | 11 +++++++
docs/03-core-concepts/_category_.yml | 1 +
docs/04-user-guide/01-client-interfaces/01-o3.md | 7 +++++
docs/04-user-guide/01-client-interfaces/02-ofs.md | 7 +++++
docs/04-user-guide/01-client-interfaces/03-s3.md | 3 ++
docs/04-user-guide/01-client-interfaces/04-s3a.md | 7 +++++
.../01-client-interfaces/05-httpfs.md | 3 ++
.../01-client-interfaces/06-java-client-api.md | 3 ++
.../01-client-interfaces/_category_.yml | 1 +
docs/04-user-guide/02-integrations/_category_.yml | 1 +
docs/04-user-guide/02-integrations/hive.md | 3 ++
docs/04-user-guide/02-integrations/hue.md | 3 ++
docs/04-user-guide/02-integrations/iceberg.md | 3 ++
docs/04-user-guide/02-integrations/impala.md | 3 ++
docs/04-user-guide/02-integrations/oozie.md | 3 ++
docs/04-user-guide/02-integrations/spark.md | 3 ++
docs/04-user-guide/02-integrations/trino.md | 3 ++
docs/04-user-guide/_category_.yml | 1 +
.../01-installation/01-deployment-architecture.md | 3 ++
.../01-installation/02-hardware-and-sizing.md | 3 ++
.../01-installation/03-installing-binaries.md | 7 +++++
.../01-installation/_category_.yml | 1 +
.../01-basic/01-network/01-ozone-manager.md | 7 +++++
.../01-network/02-storage-container-manager.md | 8 +++++
.../01-basic/01-network/03-datanode.md | 8 +++++
.../01-basic/01-network/04-recon.md | 8 +++++
.../01-basic/01-network/05-s3-gateway.md | 8 +++++
.../01-basic/01-network/07-default-ports.md | 9 ++++++
.../01-basic/01-network/_category_.yml | 1 +
.../01-basic/02-directories/01-ozone-manager.md | 7 +++++
.../02-directories/02-storage-container-manager.md | 8 +++++
.../01-basic/02-directories/03-datanode.md | 8 +++++
.../01-basic/02-directories/04-recon.md | 8 +++++
.../01-basic/02-directories/_category_.yml | 1 +
.../02-configuration/01-basic/_category_.yml | 1 +
.../02-configuration/02-logging/_category_.yml | 1 +
.../02-configuration/02-logging/placeholder.md | 5 +++
.../03-security/01-administrators.md | 10 ++++++
.../02-configuration/03-security/01-kerberos.md | 12 ++++++++
.../02-configuration/03-security/02-knox.md | 7 +++++
.../02-configuration/03-security/03-ranger.md | 7 +++++
.../01-network-encryption/01-hadoop-rpc.md | 7 +++++
.../04-encryption/01-network-encryption/02-grpc.md | 7 +++++
.../01-network-encryption/03-https.md | 7 +++++
.../01-network-encryption/_category_.yml | 1 +
.../02-transparent-data-encryption.md | 3 ++
.../03-security/04-encryption/_category_.yml | 1 +
.../02-configuration/03-security/_category_.yml | 1 +
.../02-configuration/04-performance/01-topology.md | 7 +++++
.../02-configuration/04-performance/_category_.yml | 1 +
.../02-configuration/04-performance/placeholder.md | 5 +++
.../02-configuration/_category_.yml | 1 +
.../03-operations/01-start-and-stop.md | 7 +++++
.../03-operations/02-upgrade-and-downgrade.md | 4 +++
.../01-ozone-manager.md | 7 +++++
.../02-storage-container-manager.md | 8 +++++
.../03-datanodes.md | 13 ++++++++
.../_category_.yml | 1 +
.../04-disk-replacement/01-ozone-manager.md | 7 +++++
.../02-storage-container-manager.md | 8 +++++
.../04-disk-replacement/03-datanodes.md | 8 +++++
.../03-operations/04-disk-replacement/04-recon.md | 8 +++++
.../04-disk-replacement/_category_.yml | 1 +
.../03-operations/05-balancing-datanodes.md | 4 +++
.../03-operations/06-certificate-rotation.md | 5 +++
.../03-operations/07-s3-multi-tenancy.md | 5 +++
.../03-operations/08-snapshots.md | 5 +++
.../03-operations/09-observability/01-cli.md | 8 +++++
.../09-observability/02-recon/01-recon-web-ui.md | 3 ++
.../09-observability/02-recon/02-recon-rest-api.md | 3 ++
.../09-observability/02-recon/_category_.yml | 1 +
.../03-operations/09-observability/03-web-uis.md | 5 +++
.../09-observability/04-prometheus.md | 7 +++++
.../03-operations/09-observability/05-grafana.md | 7 +++++
.../03-operations/09-observability/_category_.yml | 1 +
.../03-operations/_category_.yml | 1 +
docs/05-administrator-guide/_category_.yml | 1 +
docs/06-troubleshooting/01-startup.md | 10 ++++++
docs/06-troubleshooting/02-safemode.md | 10 ++++++
docs/06-troubleshooting/03-read-write.md | 10 ++++++
docs/06-troubleshooting/04-delete.md | 10 ++++++
docs/06-troubleshooting/05-recon.md | 8 +++++
docs/06-troubleshooting/06-performance.md | 10 ++++++
.../07-integrations/_category_.yml | 1 +
.../07-integrations/placeholder.md | 6 ++++
.../08-security/01-certificates.md | 8 +++++
.../08-security/02-authentication.md | 14 +++++++++
.../08-security/03-authorization.md | 14 +++++++++
docs/06-troubleshooting/08-security/_category_.yml | 1 +
docs/06-troubleshooting/09-upgrade-downgrade.md | 8 +++++
.../10-decommission-maintenance.md | 8 +++++
docs/06-troubleshooting/11-write-pipelines.md | 8 +++++
docs/06-troubleshooting/12-storage-containers.md | 8 +++++
docs/06-troubleshooting/13-ratis.md | 8 +++++
docs/06-troubleshooting/14-rocksdb.md | 8 +++++
docs/06-troubleshooting/_category_.yml | 1 +
.../01-ozone-manager/01-disk-layout.md | 6 ++++
.../01-ozone-manager/02-rocksdb-schema.md | 8 +++++
.../01-ozone-manager/03-in-memory-storage.md | 12 ++++++++
.../01-ozone-manager/04-startup-sequence.md | 9 ++++++
.../01-components/01-ozone-manager/05-roles.md | 8 +++++
.../01-ozone-manager/06-write-request-flow.md | 8 +++++
.../01-ozone-manager/07-read-request-flow.md | 8 +++++
.../01-components/01-ozone-manager/_category_.yml | 1 +
.../02-storage-container-manager/01-disk-layout.md | 8 +++++
.../02-rocksdb-schema.md | 8 +++++
.../03-in-memory-storage.md | 8 +++++
.../04-startup-sequence.md | 8 +++++
.../02-storage-container-manager/05-roles.md | 10 ++++++
.../06-admin-write-request-flow.md | 8 +++++
.../07-admin-read-request-flow.md | 8 +++++
.../02-storage-container-manager/_category_.yml | 1 +
.../01-components/03-datanode/01-disk-layout.md | 8 +++++
.../01-components/03-datanode/02-rocksdb-schema.md | 8 +++++
.../03-datanode/03-in-memory-storage.md | 8 +++++
.../03-datanode/04-startup-sequence.md | 8 +++++
.../03-datanode/06-write-request-flow.md | 8 +++++
.../03-datanode/07-read-request-flow.md | 8 +++++
.../01-components/03-datanode/_category_.yml | 1 +
.../01-components/04-recon/01-disk-layout.md | 8 +++++
.../01-components/04-recon/02-rocksdb-schema.md | 8 +++++
.../01-components/04-recon/03-sql-schema.md | 8 +++++
.../01-components/04-recon/04-in-memory-storage.md | 8 +++++
.../01-components/04-recon/05-startup-sequence.md | 8 +++++
.../04-recon/06-syncing-data-from-om.md | 8 +++++
.../04-recon/07-syncing-data-from-scm.md | 8 +++++
.../04-recon/08-syncing-data-from-datanodes.md | 8 +++++
.../01-components/04-recon/_category_.yml | 1 +
.../01-components/05-s3-gateway/01-overview.md | 14 +++++++++
.../01-components/05-s3-gateway/02-request-flow.md | 8 +++++
.../01-components/05-s3-gateway/_category_.yml | 1 +
.../01-components/06-client/01-startup-sequence.md | 11 +++++++
.../06-client/02-in-memory-storage.md | 11 +++++++
.../01-components/06-client/03-jars.md | 9 ++++++
.../01-components/06-client/_category_.yml | 1 +
.../01-components/_category_.yml | 1 +
.../02-data-operations/01-write.md | 36 ++++++++++++++++++++++
.../02-data-operations/02-read.md | 28 +++++++++++++++++
.../02-data-operations/03-delete.md | 25 +++++++++++++++
.../02-data-operations/04-hsync.md | 14 +++++++++
.../02-data-operations/_category_.yml | 1 +
.../03-data-integrity/01-checksums.md | 10 ++++++
.../03-data-integrity/02-container-scanner.md | 4 +++
.../03-data-integrity/03-volume-scanner.md | 4 +++
.../03-data-integrity/_category_.yml | 1 +
.../04-replication/01-metadata-replication.md | 5 +++
.../01-write-pipelines/01-overview.md | 8 +++++
.../01-write-pipelines/02-types.md | 10 ++++++
.../01-write-pipelines/03-states.md | 8 +++++
.../01-write-pipelines/04-reports.md | 8 +++++
.../01-write-pipelines/05-creation.md | 8 +++++
.../01-write-pipelines/06-persistence.md | 10 ++++++
.../01-write-pipelines/07-destruction.md | 10 ++++++
.../01-write-pipelines/_category_.yml | 1 +
.../02-containers/01-overview.md | 8 +++++
.../02-data-replication/02-containers/02-types.md | 10 ++++++
.../02-data-replication/02-containers/03-states.md | 10 ++++++
.../02-containers/04-reports.md | 8 +++++
.../02-containers/05-creation.md | 8 +++++
.../02-containers/06-persistence.md | 10 ++++++
.../02-containers/07-destruction.md | 8 +++++
.../02-containers/08-replication.md | 9 ++++++
.../02-containers/09-offline-reconstruction.md | 10 ++++++
.../02-containers/_category_.yml | 1 +
.../02-data-replication/03-replication-manager.md | 3 ++
.../02-data-replication/04-container-balancer.md | 3 ++
.../02-data-replication/_category_.yml | 1 +
.../04-replication/_category_.yml | 1 +
.../07-system-internals/05-security/01-kerberos.md | 10 ++++++
.../05-security/02-symmetric-encryption.md | 10 ++++++
docs/07-system-internals/05-security/03-tokens.md | 10 ++++++
.../05-security/04-certificates.md | 10 ++++++
docs/07-system-internals/05-security/05-tls.md | 10 ++++++
docs/07-system-internals/05-security/06-sasl.md | 8 +++++
.../05-security/07-s3-credentials.md | 10 ++++++
.../07-system-internals/05-security/_category_.yml | 1 +
.../06-network-protocols/01-overview.md | 10 ++++++
.../06-network-protocols/02-client.md | 24 +++++++++++++++
.../06-network-protocols/03-server.md | 23 ++++++++++++++
.../06-network-protocols/_category_.yml | 1 +
.../07-features/01-filesystem-optimization.md | 8 +++++
.../07-features/02-upgrade-downgrade.md | 7 +++++
.../07-features/03-bucket-snapshots.md | 8 +++++
.../07-features/04-erasure-coding.md | 8 +++++
.../07-features/05-ratis-streaming.md | 10 ++++++
.../07-system-internals/07-features/_category_.yml | 1 +
docs/07-system-internals/_category_.yml | 1 +
.../08-developer-guide/01-build/01-prerequities.md | 12 ++++++++
docs/08-developer-guide/01-build/02-maven.md | 10 ++++++
docs/08-developer-guide/01-build/03-intellij.md | 9 ++++++
.../01-build/04-docker-images.md | 11 +++++++
docs/08-developer-guide/01-build/_category_.yml | 1 +
docs/08-developer-guide/02-run/01-intellij.md | 7 +++++
.../08-developer-guide/02-run/02-docker-compose.md | 12 ++++++++
docs/08-developer-guide/02-run/_category_.yml | 1 +
docs/08-developer-guide/03-test/01-unit-tests.md | 8 +++++
.../03-test/02-integration-tests.md | 8 +++++
.../03-test/03-acceptance-tests.md | 7 +++++
.../03-test/04-continuous-integration.md | 14 +++++++++
.../03-test/05-static-analysis.md | 9 ++++++
docs/08-developer-guide/03-test/_category_.yml | 1 +
.../04-project/01-branches-and-tags.md | 14 +++++++++
.../04-project/03-release-guide.md | 9 ++++++
docs/08-developer-guide/04-project/_category_.yml | 1 +
docs/08-developer-guide/_category_.yml | 1 +
progress.sh | 31 +++++++++++++++++++
244 files changed, 1606 insertions(+), 2 deletions(-)
diff --git a/README.md b/README.md
index 1ffea30e..918e674b 100644
--- a/README.md
+++ b/README.md
@@ -14,7 +14,7 @@
# Apache Ozone Website v2
-Welcome to the development branch of the new and improved Apache Ozone
website. The new site is being built with [Docusaurus](https://docusaurus.io/).
See the [Docusaurus docs](https://docusaurus.io/docs) for details on working
with this framework.
+Welcome to the development branch of the new and improved Apache Ozone
website. The new site is being built with [Docusaurus](https://docusaurus.io/).
See the [Docusaurus docs](https://docusaurus.io/docs) for details on working
with this framework. The `progress.sh` script can be used to get an
approximation of how many pages are remaining before the website is ready.
You can preview the current state of the new website at
https://ozone-site-v2.staged.apache.org.
diff --git a/docs/01-overview.md b/docs/01-overview.md
index a5c2be18..aec72baa 100644
--- a/docs/01-overview.md
+++ b/docs/01-overview.md
@@ -5,7 +5,7 @@ slug: /
# Overview
-**TODO:** [HDDS-9864](https://issues.apache.org/jira/browse/HDDS-9864) and
complete this page
+**TODO:** [HDDS-9864](https://issues.apache.org/jira/browse/HDDS-9864)
complete this page
## What is Ozone?
diff --git a/docs/02-quick-start/01-installation/01-docker.md
b/docs/02-quick-start/01-installation/01-docker.md
new file mode 100644
index 00000000..e6a27047
--- /dev/null
+++ b/docs/02-quick-start/01-installation/01-docker.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Docker
+---
+
+# Try Ozone With Docker
+
+**TODO:** File a subtask under
[HDDS-9856](https://issues.apache.org/jira/browse/HDDS-9856) and complete this
page or section.
diff --git a/docs/02-quick-start/01-installation/02-kubernetes.md
b/docs/02-quick-start/01-installation/02-kubernetes.md
new file mode 100644
index 00000000..b78f9950
--- /dev/null
+++ b/docs/02-quick-start/01-installation/02-kubernetes.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Kubernetes
+---
+
+# Try Ozone With Kubernetes
+
+**TODO:** File a subtask under
[HDDS-9856](https://issues.apache.org/jira/browse/HDDS-9856) and complete this
page or section.
diff --git a/docs/02-quick-start/01-installation/03-bare-metal.md
b/docs/02-quick-start/01-installation/03-bare-metal.md
new file mode 100644
index 00000000..456ea13e
--- /dev/null
+++ b/docs/02-quick-start/01-installation/03-bare-metal.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Bare Metal
+---
+
+# Try Ozone on Bare Metal
+
+**TODO:** File a subtask under
[HDDS-9856](https://issues.apache.org/jira/browse/HDDS-9856) and complete this
page or section.
diff --git a/docs/02-quick-start/01-installation/_category_.yml
b/docs/02-quick-start/01-installation/_category_.yml
new file mode 100644
index 00000000..f8e427f3
--- /dev/null
+++ b/docs/02-quick-start/01-installation/_category_.yml
@@ -0,0 +1 @@
+label: Installation
diff --git a/docs/02-quick-start/02-reading-writing-data.md
b/docs/02-quick-start/02-reading-writing-data.md
new file mode 100644
index 00000000..39075d07
--- /dev/null
+++ b/docs/02-quick-start/02-reading-writing-data.md
@@ -0,0 +1,3 @@
+# Reading and Writing Data
+
+**TODO:** File a subtask under
[HDDS-9856](https://issues.apache.org/jira/browse/HDDS-9856) and complete this
page or section.
diff --git a/docs/02-quick-start/_category_.yml
b/docs/02-quick-start/_category_.yml
new file mode 100644
index 00000000..47aaff2d
--- /dev/null
+++ b/docs/02-quick-start/_category_.yml
@@ -0,0 +1 @@
+label: Quick Start
diff --git a/docs/03-core-concepts/01-architecture.md
b/docs/03-core-concepts/01-architecture.md
new file mode 100644
index 00000000..a80fa42e
--- /dev/null
+++ b/docs/03-core-concepts/01-architecture.md
@@ -0,0 +1,6 @@
+# Architecture
+
+**TODO:** File a subtask under
[HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this
page or section.
+
+A high level overview of Ozone's components and what they do.
+
diff --git a/docs/03-core-concepts/02-replication/01-storage-containers.md
b/docs/03-core-concepts/02-replication/01-storage-containers.md
new file mode 100644
index 00000000..9c627605
--- /dev/null
+++ b/docs/03-core-concepts/02-replication/01-storage-containers.md
@@ -0,0 +1,6 @@
+# Storage Containers
+
+**TODO:** File a subtask under
[HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this
page or section.
+
+Provide a high level summary of storage containers and their purpose.
Technically this is just for context and deep understanding is not required by
most users of the system. The System Internals section of the docs will have
much more details on containers.
+
diff --git a/docs/03-core-concepts/02-replication/02-write-pipelines.md
b/docs/03-core-concepts/02-replication/02-write-pipelines.md
new file mode 100644
index 00000000..733f283c
--- /dev/null
+++ b/docs/03-core-concepts/02-replication/02-write-pipelines.md
@@ -0,0 +1,6 @@
+# Write Pipelines
+
+**TODO:** File a subtask under
[HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this
page or section.
+
+Provide a high level summary of write pipelines and their purpose. Technically
this is just for context and deep understanding is not required by most users
of the system. The System Internals section of the docs will have much more
details on write pipelines.
+
diff --git a/docs/03-core-concepts/02-replication/03-ratis.md
b/docs/03-core-concepts/02-replication/03-ratis.md
new file mode 100644
index 00000000..850d78b9
--- /dev/null
+++ b/docs/03-core-concepts/02-replication/03-ratis.md
@@ -0,0 +1,3 @@
+# Ratis
+
+**TODO:** File a subtask under
[HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this
page or section.
diff --git a/docs/03-core-concepts/02-replication/04-erasure-coding.md
b/docs/03-core-concepts/02-replication/04-erasure-coding.md
new file mode 100644
index 00000000..4947b738
--- /dev/null
+++ b/docs/03-core-concepts/02-replication/04-erasure-coding.md
@@ -0,0 +1,3 @@
+# Erasure Coding
+
+**TODO:** File a subtask under
[HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this
page or section.
diff --git a/docs/03-core-concepts/02-replication/_category_.yml
b/docs/03-core-concepts/02-replication/_category_.yml
new file mode 100644
index 00000000..7fbd19da
--- /dev/null
+++ b/docs/03-core-concepts/02-replication/_category_.yml
@@ -0,0 +1 @@
+label: Replication
diff --git a/docs/03-core-concepts/03-namespace/01-overview.md
b/docs/03-core-concepts/03-namespace/01-overview.md
new file mode 100644
index 00000000..c8c958fc
--- /dev/null
+++ b/docs/03-core-concepts/03-namespace/01-overview.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Overview
+---
+
+# Overview of Ozone's Namespace
+
+**TODO:** File a subtask under
[HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this
page or section.
diff --git a/docs/03-core-concepts/03-namespace/01-volumes/01-overview.md
b/docs/03-core-concepts/03-namespace/01-volumes/01-overview.md
new file mode 100644
index 00000000..6585a633
--- /dev/null
+++ b/docs/03-core-concepts/03-namespace/01-volumes/01-overview.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Overview
+---
+
+# Volumes Overview
+
+**TODO:** File a subtask under
[HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this
page or section.
diff --git a/docs/03-core-concepts/03-namespace/01-volumes/02-owners.md
b/docs/03-core-concepts/03-namespace/01-volumes/02-owners.md
new file mode 100644
index 00000000..9bc54353
--- /dev/null
+++ b/docs/03-core-concepts/03-namespace/01-volumes/02-owners.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Owners
+---
+
+# Volume Owners
+
+**TODO:** File a subtask under
[HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this
page or section.
diff --git a/docs/03-core-concepts/03-namespace/01-volumes/03-quotas.md
b/docs/03-core-concepts/03-namespace/01-volumes/03-quotas.md
new file mode 100644
index 00000000..7a0a9e91
--- /dev/null
+++ b/docs/03-core-concepts/03-namespace/01-volumes/03-quotas.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Quotas
+---
+
+# Volume Quotas
+
+**TODO:** File a subtask under
[HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this
page or section.
diff --git a/docs/03-core-concepts/03-namespace/01-volumes/_category_.yml
b/docs/03-core-concepts/03-namespace/01-volumes/_category_.yml
new file mode 100644
index 00000000..adc35671
--- /dev/null
+++ b/docs/03-core-concepts/03-namespace/01-volumes/_category_.yml
@@ -0,0 +1 @@
+label: Volumes
diff --git a/docs/03-core-concepts/03-namespace/02-buckets/01-overview.md
b/docs/03-core-concepts/03-namespace/02-buckets/01-overview.md
new file mode 100644
index 00000000..e50ab7c4
--- /dev/null
+++ b/docs/03-core-concepts/03-namespace/02-buckets/01-overview.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Overview
+---
+
+# Buckets Overview
+
+**TODO:** File a subtask under
[HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this
page or section.
diff --git a/docs/03-core-concepts/03-namespace/02-buckets/02-owners.md
b/docs/03-core-concepts/03-namespace/02-buckets/02-owners.md
new file mode 100644
index 00000000..565c183d
--- /dev/null
+++ b/docs/03-core-concepts/03-namespace/02-buckets/02-owners.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Owners
+---
+
+# Bucket Owners
+
+**TODO:** File a subtask under
[HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this
page or section.
diff --git a/docs/03-core-concepts/03-namespace/02-buckets/03-quotas.md
b/docs/03-core-concepts/03-namespace/02-buckets/03-quotas.md
new file mode 100644
index 00000000..91cec39a
--- /dev/null
+++ b/docs/03-core-concepts/03-namespace/02-buckets/03-quotas.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Quotas
+---
+
+# Bucket Quotas
+
+**TODO:** File a subtask under
[HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this
page or section.
diff --git
a/docs/03-core-concepts/03-namespace/02-buckets/04-layouts/01-object-store.md
b/docs/03-core-concepts/03-namespace/02-buckets/04-layouts/01-object-store.md
new file mode 100644
index 00000000..b28b9b49
--- /dev/null
+++
b/docs/03-core-concepts/03-namespace/02-buckets/04-layouts/01-object-store.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Object Store (OBS)
+---
+
+# Object Store Buckets (OBS)
+
+**TODO:** File a subtask under
[HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this
page or section.
diff --git
a/docs/03-core-concepts/03-namespace/02-buckets/04-layouts/02-file-system-optimized.md
b/docs/03-core-concepts/03-namespace/02-buckets/04-layouts/02-file-system-optimized.md
new file mode 100644
index 00000000..5e6616fb
--- /dev/null
+++
b/docs/03-core-concepts/03-namespace/02-buckets/04-layouts/02-file-system-optimized.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: File System Optimized (FSO)
+---
+
+# File System Optimized Buckets (FSO)
+
+**TODO:** File a subtask under
[HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this
page or section.
diff --git
a/docs/03-core-concepts/03-namespace/02-buckets/04-layouts/_category_.yml
b/docs/03-core-concepts/03-namespace/02-buckets/04-layouts/_category_.yml
new file mode 100644
index 00000000..a30ed1ef
--- /dev/null
+++ b/docs/03-core-concepts/03-namespace/02-buckets/04-layouts/_category_.yml
@@ -0,0 +1 @@
+label: Layouts
diff --git a/docs/03-core-concepts/03-namespace/02-buckets/05-replication.md
b/docs/03-core-concepts/03-namespace/02-buckets/05-replication.md
new file mode 100644
index 00000000..d46c3422
--- /dev/null
+++ b/docs/03-core-concepts/03-namespace/02-buckets/05-replication.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Default Replication Type
+---
+
+# Bucket Level Default Replication Type
+
+**TODO:** File a subtask under
[HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this
page or section.
diff --git a/docs/03-core-concepts/03-namespace/02-buckets/06-encryption.md
b/docs/03-core-concepts/03-namespace/02-buckets/06-encryption.md
new file mode 100644
index 00000000..1f52d27a
--- /dev/null
+++ b/docs/03-core-concepts/03-namespace/02-buckets/06-encryption.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Encryption
+---
+
+# Bucket Level Encryption
+
+**TODO:** File a subtask under
[HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this
page or section.
diff --git a/docs/03-core-concepts/03-namespace/02-buckets/07-links.md
b/docs/03-core-concepts/03-namespace/02-buckets/07-links.md
new file mode 100644
index 00000000..6f68b444
--- /dev/null
+++ b/docs/03-core-concepts/03-namespace/02-buckets/07-links.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Links
+---
+
+# Bucket Links
+
+**TODO:** File a subtask under
[HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this
page or section.
diff --git a/docs/03-core-concepts/03-namespace/02-buckets/_category_.yml
b/docs/03-core-concepts/03-namespace/02-buckets/_category_.yml
new file mode 100644
index 00000000..45ac4cbb
--- /dev/null
+++ b/docs/03-core-concepts/03-namespace/02-buckets/_category_.yml
@@ -0,0 +1 @@
+label: Buckets
diff --git a/docs/03-core-concepts/03-namespace/_category_.yml
b/docs/03-core-concepts/03-namespace/_category_.yml
new file mode 100644
index 00000000..36308627
--- /dev/null
+++ b/docs/03-core-concepts/03-namespace/_category_.yml
@@ -0,0 +1 @@
+label: Namespace
diff --git a/docs/03-core-concepts/04-security/01-authentication/01-kerberos.md
b/docs/03-core-concepts/04-security/01-authentication/01-kerberos.md
new file mode 100644
index 00000000..cb0d0931
--- /dev/null
+++ b/docs/03-core-concepts/04-security/01-authentication/01-kerberos.md
@@ -0,0 +1,10 @@
+---
+sidebar_label: Kerberos
+---
+
+# Authenticating with Kerberos
+
+**TODO:** File a subtask under
[HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this
page or section.
+
+## Using SPNEGO to Authenticate with Kerberos over HTTP
+
diff --git a/docs/03-core-concepts/04-security/01-authentication/02-knox.md
b/docs/03-core-concepts/04-security/01-authentication/02-knox.md
new file mode 100644
index 00000000..0afaa222
--- /dev/null
+++ b/docs/03-core-concepts/04-security/01-authentication/02-knox.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Apache Knox
+---
+
+# Authenticating with Apache Knox
+
+**TODO:** File a subtask under
[HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this
page or section.
+
diff --git
a/docs/03-core-concepts/04-security/01-authentication/03-s3-credentials.md
b/docs/03-core-concepts/04-security/01-authentication/03-s3-credentials.md
new file mode 100644
index 00000000..c32902c0
--- /dev/null
+++ b/docs/03-core-concepts/04-security/01-authentication/03-s3-credentials.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: S3 Credentials
+---
+
+# Authenticating with S3 Credentials
+
+**TODO:** File a subtask under
[HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this
page or section.
+
diff --git a/docs/03-core-concepts/04-security/01-authentication/_category_.yml
b/docs/03-core-concepts/04-security/01-authentication/_category_.yml
new file mode 100644
index 00000000..f40bb4f6
--- /dev/null
+++ b/docs/03-core-concepts/04-security/01-authentication/_category_.yml
@@ -0,0 +1 @@
+label: Authentication
diff --git
a/docs/03-core-concepts/04-security/02-authorization/01-native-acls.md
b/docs/03-core-concepts/04-security/02-authorization/01-native-acls.md
new file mode 100644
index 00000000..730d32ce
--- /dev/null
+++ b/docs/03-core-concepts/04-security/02-authorization/01-native-acls.md
@@ -0,0 +1,3 @@
+# Native ACLs
+
+**TODO:** File a subtask under
[HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this
page or section.
diff --git
a/docs/03-core-concepts/04-security/02-authorization/02-ranger-acls.md
b/docs/03-core-concepts/04-security/02-authorization/02-ranger-acls.md
new file mode 100644
index 00000000..c239c65c
--- /dev/null
+++ b/docs/03-core-concepts/04-security/02-authorization/02-ranger-acls.md
@@ -0,0 +1,3 @@
+# Ranger ACLs
+
+**TODO:** File a subtask under
[HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this
page or section.
diff --git a/docs/03-core-concepts/04-security/02-authorization/_category_.yml
b/docs/03-core-concepts/04-security/02-authorization/_category_.yml
new file mode 100644
index 00000000..a11c44a8
--- /dev/null
+++ b/docs/03-core-concepts/04-security/02-authorization/_category_.yml
@@ -0,0 +1 @@
+label: Authorization
diff --git a/docs/03-core-concepts/04-security/_category_.yml
b/docs/03-core-concepts/04-security/_category_.yml
new file mode 100644
index 00000000..76a1b343
--- /dev/null
+++ b/docs/03-core-concepts/04-security/_category_.yml
@@ -0,0 +1 @@
+label: Security
diff --git a/docs/03-core-concepts/05-configuration-files.md
b/docs/03-core-concepts/05-configuration-files.md
new file mode 100644
index 00000000..d42b7044
--- /dev/null
+++ b/docs/03-core-concepts/05-configuration-files.md
@@ -0,0 +1,11 @@
+# Configuration Files
+
+**TODO:** File a subtask under
[HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this
page or section.
+
+Covers what configuration files exist in the system, their basic format, and
where they are read from. Does not cover specific config keys to use.
+- ozone-site.xml
+- core-site.xml
+- application log4j
+- audit log4j
+- client log4j
+
diff --git a/docs/03-core-concepts/_category_.yml
b/docs/03-core-concepts/_category_.yml
new file mode 100644
index 00000000..7807cb0c
--- /dev/null
+++ b/docs/03-core-concepts/_category_.yml
@@ -0,0 +1 @@
+label: Core Concepts
diff --git a/docs/04-user-guide/01-client-interfaces/01-o3.md
b/docs/04-user-guide/01-client-interfaces/01-o3.md
new file mode 100644
index 00000000..b7dbae5f
--- /dev/null
+++ b/docs/04-user-guide/01-client-interfaces/01-o3.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: o3 (Ozone Shell)
+---
+
+# o3: Ozone Shell
+
+**TODO:** File a subtask under
[HDDS-9858](https://issues.apache.org/jira/browse/HDDS-9858) and complete this
page or section.
diff --git a/docs/04-user-guide/01-client-interfaces/02-ofs.md
b/docs/04-user-guide/01-client-interfaces/02-ofs.md
new file mode 100644
index 00000000..033df71a
--- /dev/null
+++ b/docs/04-user-guide/01-client-interfaces/02-ofs.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: ofs
+---
+
+# ofs: Hadoop Compatible Interface
+
+**TODO:** File a subtask under
[HDDS-9858](https://issues.apache.org/jira/browse/HDDS-9858) and complete this
page or section.
diff --git a/docs/04-user-guide/01-client-interfaces/03-s3.md
b/docs/04-user-guide/01-client-interfaces/03-s3.md
new file mode 100644
index 00000000..9e60525e
--- /dev/null
+++ b/docs/04-user-guide/01-client-interfaces/03-s3.md
@@ -0,0 +1,3 @@
+# S3 API
+
+**TODO:** File a subtask under
[HDDS-9858](https://issues.apache.org/jira/browse/HDDS-9858) and complete this
page or section.
diff --git a/docs/04-user-guide/01-client-interfaces/04-s3a.md
b/docs/04-user-guide/01-client-interfaces/04-s3a.md
new file mode 100644
index 00000000..9ca8b8d6
--- /dev/null
+++ b/docs/04-user-guide/01-client-interfaces/04-s3a.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: s3a
+---
+
+# Accessing Ozone with s3a
+
+**TODO:** File a subtask under
[HDDS-9858](https://issues.apache.org/jira/browse/HDDS-9858) and complete this
page or section.
diff --git a/docs/04-user-guide/01-client-interfaces/05-httpfs.md
b/docs/04-user-guide/01-client-interfaces/05-httpfs.md
new file mode 100644
index 00000000..c1f06ef4
--- /dev/null
+++ b/docs/04-user-guide/01-client-interfaces/05-httpfs.md
@@ -0,0 +1,3 @@
+# HttpFS
+
+**TODO:** File a subtask under
[HDDS-9858](https://issues.apache.org/jira/browse/HDDS-9858) and complete this
page or section.
diff --git a/docs/04-user-guide/01-client-interfaces/06-java-client-api.md
b/docs/04-user-guide/01-client-interfaces/06-java-client-api.md
new file mode 100644
index 00000000..111ea9d4
--- /dev/null
+++ b/docs/04-user-guide/01-client-interfaces/06-java-client-api.md
@@ -0,0 +1,3 @@
+# Java Client API
+
+**TODO:** File a subtask under
[HDDS-9858](https://issues.apache.org/jira/browse/HDDS-9858) and complete this
page or section.
diff --git a/docs/04-user-guide/01-client-interfaces/_category_.yml
b/docs/04-user-guide/01-client-interfaces/_category_.yml
new file mode 100644
index 00000000..3cfa4069
--- /dev/null
+++ b/docs/04-user-guide/01-client-interfaces/_category_.yml
@@ -0,0 +1 @@
+label: Client Interfaces
diff --git a/docs/04-user-guide/02-integrations/_category_.yml
b/docs/04-user-guide/02-integrations/_category_.yml
new file mode 100644
index 00000000..08b3b4a1
--- /dev/null
+++ b/docs/04-user-guide/02-integrations/_category_.yml
@@ -0,0 +1 @@
+label: Integrations
diff --git a/docs/04-user-guide/02-integrations/hive.md
b/docs/04-user-guide/02-integrations/hive.md
new file mode 100644
index 00000000..c5966949
--- /dev/null
+++ b/docs/04-user-guide/02-integrations/hive.md
@@ -0,0 +1,3 @@
+# Hive
+
+**TODO:** File a subtask under
[HDDS-9858](https://issues.apache.org/jira/browse/HDDS-9858) and complete this
page or section.
diff --git a/docs/04-user-guide/02-integrations/hue.md
b/docs/04-user-guide/02-integrations/hue.md
new file mode 100644
index 00000000..06bb22e2
--- /dev/null
+++ b/docs/04-user-guide/02-integrations/hue.md
@@ -0,0 +1,3 @@
+# Hue
+
+**TODO:** File a subtask under
[HDDS-9858](https://issues.apache.org/jira/browse/HDDS-9858) and complete this
page or section.
diff --git a/docs/04-user-guide/02-integrations/iceberg.md
b/docs/04-user-guide/02-integrations/iceberg.md
new file mode 100644
index 00000000..408ec7c2
--- /dev/null
+++ b/docs/04-user-guide/02-integrations/iceberg.md
@@ -0,0 +1,3 @@
+# Iceberg
+
+**TODO:** File a subtask under
[HDDS-9858](https://issues.apache.org/jira/browse/HDDS-9858) and complete this
page or section.
diff --git a/docs/04-user-guide/02-integrations/impala.md
b/docs/04-user-guide/02-integrations/impala.md
new file mode 100644
index 00000000..1682a1c3
--- /dev/null
+++ b/docs/04-user-guide/02-integrations/impala.md
@@ -0,0 +1,3 @@
+# Impala
+
+**TODO:** File a subtask under
[HDDS-9858](https://issues.apache.org/jira/browse/HDDS-9858) and complete this
page or section.
diff --git a/docs/04-user-guide/02-integrations/oozie.md
b/docs/04-user-guide/02-integrations/oozie.md
new file mode 100644
index 00000000..b4c4de4d
--- /dev/null
+++ b/docs/04-user-guide/02-integrations/oozie.md
@@ -0,0 +1,3 @@
+# Oozie
+
+**TODO:** File a subtask under
[HDDS-9858](https://issues.apache.org/jira/browse/HDDS-9858) and complete this
page or section.
diff --git a/docs/04-user-guide/02-integrations/spark.md
b/docs/04-user-guide/02-integrations/spark.md
new file mode 100644
index 00000000..5d0235c2
--- /dev/null
+++ b/docs/04-user-guide/02-integrations/spark.md
@@ -0,0 +1,3 @@
+# Spark
+
+**TODO:** File a subtask under
[HDDS-9858](https://issues.apache.org/jira/browse/HDDS-9858) and complete this
page or section.
diff --git a/docs/04-user-guide/02-integrations/trino.md
b/docs/04-user-guide/02-integrations/trino.md
new file mode 100644
index 00000000..1ca7d467
--- /dev/null
+++ b/docs/04-user-guide/02-integrations/trino.md
@@ -0,0 +1,3 @@
+# Trino
+
+**TODO:** File a subtask under
[HDDS-9858](https://issues.apache.org/jira/browse/HDDS-9858) and complete this
page or section.
diff --git a/docs/04-user-guide/_category_.yml
b/docs/04-user-guide/_category_.yml
new file mode 100644
index 00000000..14dc26c6
--- /dev/null
+++ b/docs/04-user-guide/_category_.yml
@@ -0,0 +1 @@
+label: User Guide
diff --git
a/docs/05-administrator-guide/01-installation/01-deployment-architecture.md
b/docs/05-administrator-guide/01-installation/01-deployment-architecture.md
new file mode 100644
index 00000000..6c1cce63
--- /dev/null
+++ b/docs/05-administrator-guide/01-installation/01-deployment-architecture.md
@@ -0,0 +1,3 @@
+# Deployment Architecture
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
diff --git
a/docs/05-administrator-guide/01-installation/02-hardware-and-sizing.md
b/docs/05-administrator-guide/01-installation/02-hardware-and-sizing.md
new file mode 100644
index 00000000..e38a68d8
--- /dev/null
+++ b/docs/05-administrator-guide/01-installation/02-hardware-and-sizing.md
@@ -0,0 +1,3 @@
+# Hardware and Sizing
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
diff --git
a/docs/05-administrator-guide/01-installation/03-installing-binaries.md
b/docs/05-administrator-guide/01-installation/03-installing-binaries.md
new file mode 100644
index 00000000..1516632b
--- /dev/null
+++ b/docs/05-administrator-guide/01-installation/03-installing-binaries.md
@@ -0,0 +1,7 @@
+# Installing the Ozone Binaries
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
+To obtain binaries, link either:
+- Downloads page to get the released tarball
+- Developer guide to build from source.
diff --git a/docs/05-administrator-guide/01-installation/_category_.yml
b/docs/05-administrator-guide/01-installation/_category_.yml
new file mode 100644
index 00000000..f8e427f3
--- /dev/null
+++ b/docs/05-administrator-guide/01-installation/_category_.yml
@@ -0,0 +1 @@
+label: Installation
diff --git
a/docs/05-administrator-guide/02-configuration/01-basic/01-network/01-ozone-manager.md
b/docs/05-administrator-guide/02-configuration/01-basic/01-network/01-ozone-manager.md
new file mode 100644
index 00000000..4d7e9b01
--- /dev/null
+++
b/docs/05-administrator-guide/02-configuration/01-basic/01-network/01-ozone-manager.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Ozone Manager
+---
+
+# Network Configuration for Ozone Manager
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
diff --git
a/docs/05-administrator-guide/02-configuration/01-basic/01-network/02-storage-container-manager.md
b/docs/05-administrator-guide/02-configuration/01-basic/01-network/02-storage-container-manager.md
new file mode 100644
index 00000000..52e2e02f
--- /dev/null
+++
b/docs/05-administrator-guide/02-configuration/01-basic/01-network/02-storage-container-manager.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Storage Container Manager
+---
+
+# Network Configuration for Storage Container Manager
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
diff --git
a/docs/05-administrator-guide/02-configuration/01-basic/01-network/03-datanode.md
b/docs/05-administrator-guide/02-configuration/01-basic/01-network/03-datanode.md
new file mode 100644
index 00000000..7b2df75e
--- /dev/null
+++
b/docs/05-administrator-guide/02-configuration/01-basic/01-network/03-datanode.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Datanodes
+---
+
+# Network Configuration for Datanodes
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
diff --git
a/docs/05-administrator-guide/02-configuration/01-basic/01-network/04-recon.md
b/docs/05-administrator-guide/02-configuration/01-basic/01-network/04-recon.md
new file mode 100644
index 00000000..03c519eb
--- /dev/null
+++
b/docs/05-administrator-guide/02-configuration/01-basic/01-network/04-recon.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Recon
+---
+
+# Network Configuration for Recon
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
diff --git
a/docs/05-administrator-guide/02-configuration/01-basic/01-network/05-s3-gateway.md
b/docs/05-administrator-guide/02-configuration/01-basic/01-network/05-s3-gateway.md
new file mode 100644
index 00000000..5b070f9a
--- /dev/null
+++
b/docs/05-administrator-guide/02-configuration/01-basic/01-network/05-s3-gateway.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: S3 Gateways
+---
+
+# Network Configuration for S3 Gateways
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
diff --git
a/docs/05-administrator-guide/02-configuration/01-basic/01-network/07-default-ports.md
b/docs/05-administrator-guide/02-configuration/01-basic/01-network/07-default-ports.md
new file mode 100644
index 00000000..aad1901e
--- /dev/null
+++
b/docs/05-administrator-guide/02-configuration/01-basic/01-network/07-default-ports.md
@@ -0,0 +1,9 @@
+---
+sidebar_label: Default Ports
+---
+
+# Default Ports Used by Ozone
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
+Include a list of all default port values used throughout Ozone.
diff --git
a/docs/05-administrator-guide/02-configuration/01-basic/01-network/_category_.yml
b/docs/05-administrator-guide/02-configuration/01-basic/01-network/_category_.yml
new file mode 100644
index 00000000..47237dd2
--- /dev/null
+++
b/docs/05-administrator-guide/02-configuration/01-basic/01-network/_category_.yml
@@ -0,0 +1 @@
+label: Network
diff --git
a/docs/05-administrator-guide/02-configuration/01-basic/02-directories/01-ozone-manager.md
b/docs/05-administrator-guide/02-configuration/01-basic/02-directories/01-ozone-manager.md
new file mode 100644
index 00000000..d3607231
--- /dev/null
+++
b/docs/05-administrator-guide/02-configuration/01-basic/02-directories/01-ozone-manager.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Ozone Manager
+---
+
+# Directory Configurations for Ozone Manager
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
diff --git
a/docs/05-administrator-guide/02-configuration/01-basic/02-directories/02-storage-container-manager.md
b/docs/05-administrator-guide/02-configuration/01-basic/02-directories/02-storage-container-manager.md
new file mode 100644
index 00000000..cd968ebf
--- /dev/null
+++
b/docs/05-administrator-guide/02-configuration/01-basic/02-directories/02-storage-container-manager.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Storage Container Manager
+---
+
+# Directory Configurations for Storage Container Manager
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
diff --git
a/docs/05-administrator-guide/02-configuration/01-basic/02-directories/03-datanode.md
b/docs/05-administrator-guide/02-configuration/01-basic/02-directories/03-datanode.md
new file mode 100644
index 00000000..fe2048fd
--- /dev/null
+++
b/docs/05-administrator-guide/02-configuration/01-basic/02-directories/03-datanode.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Datanodes
+---
+
+# Directory Configurations for Datanodes
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
diff --git
a/docs/05-administrator-guide/02-configuration/01-basic/02-directories/04-recon.md
b/docs/05-administrator-guide/02-configuration/01-basic/02-directories/04-recon.md
new file mode 100644
index 00000000..3fe4c3c5
--- /dev/null
+++
b/docs/05-administrator-guide/02-configuration/01-basic/02-directories/04-recon.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Recon
+---
+
+# Directory Configurations for Recon
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
diff --git
a/docs/05-administrator-guide/02-configuration/01-basic/02-directories/_category_.yml
b/docs/05-administrator-guide/02-configuration/01-basic/02-directories/_category_.yml
new file mode 100644
index 00000000..d95ed7ec
--- /dev/null
+++
b/docs/05-administrator-guide/02-configuration/01-basic/02-directories/_category_.yml
@@ -0,0 +1 @@
+label: Directories
diff --git
a/docs/05-administrator-guide/02-configuration/01-basic/_category_.yml
b/docs/05-administrator-guide/02-configuration/01-basic/_category_.yml
new file mode 100644
index 00000000..d22ee36e
--- /dev/null
+++ b/docs/05-administrator-guide/02-configuration/01-basic/_category_.yml
@@ -0,0 +1 @@
+label: Basic
diff --git
a/docs/05-administrator-guide/02-configuration/02-logging/_category_.yml
b/docs/05-administrator-guide/02-configuration/02-logging/_category_.yml
new file mode 100644
index 00000000..a376e73e
--- /dev/null
+++ b/docs/05-administrator-guide/02-configuration/02-logging/_category_.yml
@@ -0,0 +1 @@
+label: Logging
diff --git
a/docs/05-administrator-guide/02-configuration/02-logging/placeholder.md
b/docs/05-administrator-guide/02-configuration/02-logging/placeholder.md
new file mode 100644
index 00000000..dff86927
--- /dev/null
+++ b/docs/05-administrator-guide/02-configuration/02-logging/placeholder.md
@@ -0,0 +1,5 @@
+# PLACEHOLDER
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
+There will be multiple pages on performance under this section. Not sure what
is required yet.
diff --git
a/docs/05-administrator-guide/02-configuration/03-security/01-administrators.md
b/docs/05-administrator-guide/02-configuration/03-security/01-administrators.md
new file mode 100644
index 00000000..61ba97e8
--- /dev/null
+++
b/docs/05-administrator-guide/02-configuration/03-security/01-administrators.md
@@ -0,0 +1,10 @@
+---
+sidebar_label: Administrators
+---
+
+# Configuring Ozone Administrators
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
+Ozone has many configurations for administrators. Document their default
values, and usage of ozone admin users and groups, recon admin users and
groups, and s3 admin user and groups.
+
diff --git
a/docs/05-administrator-guide/02-configuration/03-security/01-kerberos.md
b/docs/05-administrator-guide/02-configuration/03-security/01-kerberos.md
new file mode 100644
index 00000000..0e673abd
--- /dev/null
+++ b/docs/05-administrator-guide/02-configuration/03-security/01-kerberos.md
@@ -0,0 +1,12 @@
+---
+sidebar_label: Kerberos
+---
+
+# Configuring Kerberos
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
+## Configuring SPNEGO
+
+This section will probably be pretty short so we can combine it with the
Kerberos section.
+
diff --git
a/docs/05-administrator-guide/02-configuration/03-security/02-knox.md
b/docs/05-administrator-guide/02-configuration/03-security/02-knox.md
new file mode 100644
index 00000000..7ccb2f12
--- /dev/null
+++ b/docs/05-administrator-guide/02-configuration/03-security/02-knox.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Apache Knox
+---
+
+# Configuring Apache Knox
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
diff --git
a/docs/05-administrator-guide/02-configuration/03-security/03-ranger.md
b/docs/05-administrator-guide/02-configuration/03-security/03-ranger.md
new file mode 100644
index 00000000..76d5a821
--- /dev/null
+++ b/docs/05-administrator-guide/02-configuration/03-security/03-ranger.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Apache Ranger
+---
+
+# Configuring Apache Ranger
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
diff --git
a/docs/05-administrator-guide/02-configuration/03-security/04-encryption/01-network-encryption/01-hadoop-rpc.md
b/docs/05-administrator-guide/02-configuration/03-security/04-encryption/01-network-encryption/01-hadoop-rpc.md
new file mode 100644
index 00000000..918f5eff
--- /dev/null
+++
b/docs/05-administrator-guide/02-configuration/03-security/04-encryption/01-network-encryption/01-hadoop-rpc.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Hadoop RPC
+---
+
+# Configuring Hadoop RPC With SASL
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
diff --git
a/docs/05-administrator-guide/02-configuration/03-security/04-encryption/01-network-encryption/02-grpc.md
b/docs/05-administrator-guide/02-configuration/03-security/04-encryption/01-network-encryption/02-grpc.md
new file mode 100644
index 00000000..3796ea9c
--- /dev/null
+++
b/docs/05-administrator-guide/02-configuration/03-security/04-encryption/01-network-encryption/02-grpc.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: GRPC
+---
+
+# Configuring GRPC With TLS
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
diff --git
a/docs/05-administrator-guide/02-configuration/03-security/04-encryption/01-network-encryption/03-https.md
b/docs/05-administrator-guide/02-configuration/03-security/04-encryption/01-network-encryption/03-https.md
new file mode 100644
index 00000000..7657ff23
--- /dev/null
+++
b/docs/05-administrator-guide/02-configuration/03-security/04-encryption/01-network-encryption/03-https.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: HTTPS
+---
+
+# Configuring HTTPS
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
diff --git
a/docs/05-administrator-guide/02-configuration/03-security/04-encryption/01-network-encryption/_category_.yml
b/docs/05-administrator-guide/02-configuration/03-security/04-encryption/01-network-encryption/_category_.yml
new file mode 100644
index 00000000..6395d9ff
--- /dev/null
+++
b/docs/05-administrator-guide/02-configuration/03-security/04-encryption/01-network-encryption/_category_.yml
@@ -0,0 +1 @@
+label: Network Encryption
diff --git
a/docs/05-administrator-guide/02-configuration/03-security/04-encryption/02-transparent-data-encryption.md
b/docs/05-administrator-guide/02-configuration/03-security/04-encryption/02-transparent-data-encryption.md
new file mode 100644
index 00000000..ee23a354
--- /dev/null
+++
b/docs/05-administrator-guide/02-configuration/03-security/04-encryption/02-transparent-data-encryption.md
@@ -0,0 +1,3 @@
+# Transparent Data Encryption (TDE)
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
diff --git
a/docs/05-administrator-guide/02-configuration/03-security/04-encryption/_category_.yml
b/docs/05-administrator-guide/02-configuration/03-security/04-encryption/_category_.yml
new file mode 100644
index 00000000..e2fca438
--- /dev/null
+++
b/docs/05-administrator-guide/02-configuration/03-security/04-encryption/_category_.yml
@@ -0,0 +1 @@
+label: Encryption
diff --git
a/docs/05-administrator-guide/02-configuration/03-security/_category_.yml
b/docs/05-administrator-guide/02-configuration/03-security/_category_.yml
new file mode 100644
index 00000000..76a1b343
--- /dev/null
+++ b/docs/05-administrator-guide/02-configuration/03-security/_category_.yml
@@ -0,0 +1 @@
+label: Security
diff --git
a/docs/05-administrator-guide/02-configuration/04-performance/01-topology.md
b/docs/05-administrator-guide/02-configuration/04-performance/01-topology.md
new file mode 100644
index 00000000..7ac7678e
--- /dev/null
+++ b/docs/05-administrator-guide/02-configuration/04-performance/01-topology.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Topology
+---
+
+# Configuring Network Topology
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
diff --git
a/docs/05-administrator-guide/02-configuration/04-performance/_category_.yml
b/docs/05-administrator-guide/02-configuration/04-performance/_category_.yml
new file mode 100644
index 00000000..49a3a542
--- /dev/null
+++ b/docs/05-administrator-guide/02-configuration/04-performance/_category_.yml
@@ -0,0 +1 @@
+label: Performance
diff --git
a/docs/05-administrator-guide/02-configuration/04-performance/placeholder.md
b/docs/05-administrator-guide/02-configuration/04-performance/placeholder.md
new file mode 100644
index 00000000..dff86927
--- /dev/null
+++ b/docs/05-administrator-guide/02-configuration/04-performance/placeholder.md
@@ -0,0 +1,5 @@
+# PLACEHOLDER
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
+There will be multiple pages on performance under this section. Not sure what
is required yet.
diff --git a/docs/05-administrator-guide/02-configuration/_category_.yml
b/docs/05-administrator-guide/02-configuration/_category_.yml
new file mode 100644
index 00000000..b219a3af
--- /dev/null
+++ b/docs/05-administrator-guide/02-configuration/_category_.yml
@@ -0,0 +1 @@
+label: Configuration
diff --git a/docs/05-administrator-guide/03-operations/01-start-and-stop.md
b/docs/05-administrator-guide/03-operations/01-start-and-stop.md
new file mode 100644
index 00000000..22ff7096
--- /dev/null
+++ b/docs/05-administrator-guide/03-operations/01-start-and-stop.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Start and Stop
+---
+
+# Starting and Stopping the Ozone Cluster
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
diff --git
a/docs/05-administrator-guide/03-operations/02-upgrade-and-downgrade.md
b/docs/05-administrator-guide/03-operations/02-upgrade-and-downgrade.md
new file mode 100644
index 00000000..8185117c
--- /dev/null
+++ b/docs/05-administrator-guide/03-operations/02-upgrade-and-downgrade.md
@@ -0,0 +1,4 @@
+# Upgrade and Downgrade
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
diff --git
a/docs/05-administrator-guide/03-operations/03-node-decommissioning-and-maintenance/01-ozone-manager.md
b/docs/05-administrator-guide/03-operations/03-node-decommissioning-and-maintenance/01-ozone-manager.md
new file mode 100644
index 00000000..b87e9592
--- /dev/null
+++
b/docs/05-administrator-guide/03-operations/03-node-decommissioning-and-maintenance/01-ozone-manager.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Ozone Manager
+---
+
+# Decommissioning an Ozone Manager
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
diff --git
a/docs/05-administrator-guide/03-operations/03-node-decommissioning-and-maintenance/02-storage-container-manager.md
b/docs/05-administrator-guide/03-operations/03-node-decommissioning-and-maintenance/02-storage-container-manager.md
new file mode 100644
index 00000000..eb46c35b
--- /dev/null
+++
b/docs/05-administrator-guide/03-operations/03-node-decommissioning-and-maintenance/02-storage-container-manager.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Storage Container Manager
+---
+
+# Decommissioning a Storage Container Manager
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
diff --git
a/docs/05-administrator-guide/03-operations/03-node-decommissioning-and-maintenance/03-datanodes.md
b/docs/05-administrator-guide/03-operations/03-node-decommissioning-and-maintenance/03-datanodes.md
new file mode 100644
index 00000000..cadfe000
--- /dev/null
+++
b/docs/05-administrator-guide/03-operations/03-node-decommissioning-and-maintenance/03-datanodes.md
@@ -0,0 +1,13 @@
+---
+sidebar_label: Datanodes
+---
+
+# Decommissioning and Maintenance Modes for Datanodes
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
+## Decommissioning
+
+## Maintenance
+
+
diff --git
a/docs/05-administrator-guide/03-operations/03-node-decommissioning-and-maintenance/_category_.yml
b/docs/05-administrator-guide/03-operations/03-node-decommissioning-and-maintenance/_category_.yml
new file mode 100644
index 00000000..6b8e2a63
--- /dev/null
+++
b/docs/05-administrator-guide/03-operations/03-node-decommissioning-and-maintenance/_category_.yml
@@ -0,0 +1 @@
+label: Node Decommissioning and Maintenance
diff --git
a/docs/05-administrator-guide/03-operations/04-disk-replacement/01-ozone-manager.md
b/docs/05-administrator-guide/03-operations/04-disk-replacement/01-ozone-manager.md
new file mode 100644
index 00000000..0ee97454
--- /dev/null
+++
b/docs/05-administrator-guide/03-operations/04-disk-replacement/01-ozone-manager.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Ozone Manager
+---
+
+# Replacing Ozone Manager Disks
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
diff --git
a/docs/05-administrator-guide/03-operations/04-disk-replacement/02-storage-container-manager.md
b/docs/05-administrator-guide/03-operations/04-disk-replacement/02-storage-container-manager.md
new file mode 100644
index 00000000..3063ce2e
--- /dev/null
+++
b/docs/05-administrator-guide/03-operations/04-disk-replacement/02-storage-container-manager.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Storage Container Manager
+---
+
+# Replacing Storage Container Manager Disks
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
diff --git
a/docs/05-administrator-guide/03-operations/04-disk-replacement/03-datanodes.md
b/docs/05-administrator-guide/03-operations/04-disk-replacement/03-datanodes.md
new file mode 100644
index 00000000..8906dcfe
--- /dev/null
+++
b/docs/05-administrator-guide/03-operations/04-disk-replacement/03-datanodes.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Datanodes
+---
+
+# Replacing Datanode Disks
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
diff --git
a/docs/05-administrator-guide/03-operations/04-disk-replacement/04-recon.md
b/docs/05-administrator-guide/03-operations/04-disk-replacement/04-recon.md
new file mode 100644
index 00000000..e0b915a0
--- /dev/null
+++ b/docs/05-administrator-guide/03-operations/04-disk-replacement/04-recon.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Recon
+---
+
+# Replacing Recon Disks
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
diff --git
a/docs/05-administrator-guide/03-operations/04-disk-replacement/_category_.yml
b/docs/05-administrator-guide/03-operations/04-disk-replacement/_category_.yml
new file mode 100644
index 00000000..292171e0
--- /dev/null
+++
b/docs/05-administrator-guide/03-operations/04-disk-replacement/_category_.yml
@@ -0,0 +1 @@
+label: Disk Replacement
diff --git
a/docs/05-administrator-guide/03-operations/05-balancing-datanodes.md
b/docs/05-administrator-guide/03-operations/05-balancing-datanodes.md
new file mode 100644
index 00000000..1066bcb7
--- /dev/null
+++ b/docs/05-administrator-guide/03-operations/05-balancing-datanodes.md
@@ -0,0 +1,4 @@
+# Balancing Datanodes
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
diff --git
a/docs/05-administrator-guide/03-operations/06-certificate-rotation.md
b/docs/05-administrator-guide/03-operations/06-certificate-rotation.md
new file mode 100644
index 00000000..642fe84c
--- /dev/null
+++ b/docs/05-administrator-guide/03-operations/06-certificate-rotation.md
@@ -0,0 +1,5 @@
+# Certificate Rotation
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
+This page may need to be split into a header with multiple sub-pages. If extra
configuration is necessary, a page may be needed under the configuration
section of the admin guide as well.
diff --git a/docs/05-administrator-guide/03-operations/07-s3-multi-tenancy.md
b/docs/05-administrator-guide/03-operations/07-s3-multi-tenancy.md
new file mode 100644
index 00000000..973d1266
--- /dev/null
+++ b/docs/05-administrator-guide/03-operations/07-s3-multi-tenancy.md
@@ -0,0 +1,5 @@
+# S3 Multi-Tenancy
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
+This page may need to be broken into a drop-down with multiple sections on
motivation, configuration, usage, etc.
diff --git a/docs/05-administrator-guide/03-operations/08-snapshots.md
b/docs/05-administrator-guide/03-operations/08-snapshots.md
new file mode 100644
index 00000000..30335110
--- /dev/null
+++ b/docs/05-administrator-guide/03-operations/08-snapshots.md
@@ -0,0 +1,5 @@
+# Snapshots
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
+This page may need to be broken down into a section with multiple sub-pages.
diff --git
a/docs/05-administrator-guide/03-operations/09-observability/01-cli.md
b/docs/05-administrator-guide/03-operations/09-observability/01-cli.md
new file mode 100644
index 00000000..1aca902e
--- /dev/null
+++ b/docs/05-administrator-guide/03-operations/09-observability/01-cli.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: CLI
+---
+
+# Admin CLI
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
diff --git
a/docs/05-administrator-guide/03-operations/09-observability/02-recon/01-recon-web-ui.md
b/docs/05-administrator-guide/03-operations/09-observability/02-recon/01-recon-web-ui.md
new file mode 100644
index 00000000..87b802a4
--- /dev/null
+++
b/docs/05-administrator-guide/03-operations/09-observability/02-recon/01-recon-web-ui.md
@@ -0,0 +1,3 @@
+# Recon Web UI
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
diff --git
a/docs/05-administrator-guide/03-operations/09-observability/02-recon/02-recon-rest-api.md
b/docs/05-administrator-guide/03-operations/09-observability/02-recon/02-recon-rest-api.md
new file mode 100644
index 00000000..aec34944
--- /dev/null
+++
b/docs/05-administrator-guide/03-operations/09-observability/02-recon/02-recon-rest-api.md
@@ -0,0 +1,3 @@
+# Recon REST API
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
diff --git
a/docs/05-administrator-guide/03-operations/09-observability/02-recon/_category_.yml
b/docs/05-administrator-guide/03-operations/09-observability/02-recon/_category_.yml
new file mode 100644
index 00000000..3b40c251
--- /dev/null
+++
b/docs/05-administrator-guide/03-operations/09-observability/02-recon/_category_.yml
@@ -0,0 +1 @@
+label: Recon
diff --git
a/docs/05-administrator-guide/03-operations/09-observability/03-web-uis.md
b/docs/05-administrator-guide/03-operations/09-observability/03-web-uis.md
new file mode 100644
index 00000000..29372cdf
--- /dev/null
+++ b/docs/05-administrator-guide/03-operations/09-observability/03-web-uis.md
@@ -0,0 +1,5 @@
+# Web UIs
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+
+
diff --git
a/docs/05-administrator-guide/03-operations/09-observability/04-prometheus.md
b/docs/05-administrator-guide/03-operations/09-observability/04-prometheus.md
new file mode 100644
index 00000000..bfc8cbcd
--- /dev/null
+++
b/docs/05-administrator-guide/03-operations/09-observability/04-prometheus.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Prometheus
+---
+
+# Tracking Metrics With Prometheus
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
diff --git
a/docs/05-administrator-guide/03-operations/09-observability/05-grafana.md
b/docs/05-administrator-guide/03-operations/09-observability/05-grafana.md
new file mode 100644
index 00000000..43b200c9
--- /dev/null
+++ b/docs/05-administrator-guide/03-operations/09-observability/05-grafana.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Grafana
+---
+
+# Dashboarding With Grafana
+
+**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
diff --git
a/docs/05-administrator-guide/03-operations/09-observability/_category_.yml
b/docs/05-administrator-guide/03-operations/09-observability/_category_.yml
new file mode 100644
index 00000000..cebf0fd8
--- /dev/null
+++ b/docs/05-administrator-guide/03-operations/09-observability/_category_.yml
@@ -0,0 +1 @@
+label: Observability
diff --git a/docs/05-administrator-guide/03-operations/_category_.yml
b/docs/05-administrator-guide/03-operations/_category_.yml
new file mode 100644
index 00000000..5f4faaac
--- /dev/null
+++ b/docs/05-administrator-guide/03-operations/_category_.yml
@@ -0,0 +1 @@
+label: Operations
diff --git a/docs/05-administrator-guide/_category_.yml
b/docs/05-administrator-guide/_category_.yml
new file mode 100644
index 00000000..71635757
--- /dev/null
+++ b/docs/05-administrator-guide/_category_.yml
@@ -0,0 +1 @@
+label: Administrator Guide
diff --git a/docs/06-troubleshooting/01-startup.md
b/docs/06-troubleshooting/01-startup.md
new file mode 100644
index 00000000..6d9ff481
--- /dev/null
+++ b/docs/06-troubleshooting/01-startup.md
@@ -0,0 +1,10 @@
+---
+sidebar_label: Startup
+---
+
+# Troubleshooting Startup
+
+**TODO:** File a subtask under
[HDDS-9860](https://issues.apache.org/jira/browse/HDDS-9860) and complete this
page or section.
+
+If issues that show up here are caused by other problems (like certificates),
this page should link to the troubleshooting pages for those aspects.
+
diff --git a/docs/06-troubleshooting/02-safemode.md
b/docs/06-troubleshooting/02-safemode.md
new file mode 100644
index 00000000..fd4a7391
--- /dev/null
+++ b/docs/06-troubleshooting/02-safemode.md
@@ -0,0 +1,10 @@
+---
+sidebar_label: Safemode
+---
+
+# Troubleshooting Storage Container Manager Safemode
+
+**TODO:** File a subtask under
[HDDS-9860](https://issues.apache.org/jira/browse/HDDS-9860) and complete this
page or section.
+
+If issues that show up here are caused by other problems (like write
pipelines), this page should link to the troubleshooting pages for those
aspects.
+
diff --git a/docs/06-troubleshooting/03-read-write.md
b/docs/06-troubleshooting/03-read-write.md
new file mode 100644
index 00000000..0bfb3e6f
--- /dev/null
+++ b/docs/06-troubleshooting/03-read-write.md
@@ -0,0 +1,10 @@
+---
+sidebar_label: Read and Write
+---
+
+# Troubleshooting Read and Write Operations
+
+**TODO:** File a subtask under
[HDDS-9860](https://issues.apache.org/jira/browse/HDDS-9860) and complete this
page or section.
+
+If issues that show up here are caused by other problems (like write
pipelines), this page should link to the troubleshooting pages for those
aspects.
+
diff --git a/docs/06-troubleshooting/04-delete.md
b/docs/06-troubleshooting/04-delete.md
new file mode 100644
index 00000000..3ffb6ce6
--- /dev/null
+++ b/docs/06-troubleshooting/04-delete.md
@@ -0,0 +1,10 @@
+---
+sidebar_label: Delete
+---
+
+# Troubleshooting Delete Operations
+
+**TODO:** File a subtask under
[HDDS-9860](https://issues.apache.org/jira/browse/HDDS-9860) and complete this
page or section.
+
+This page may need to reference the System Internals page for data deletion.
+
diff --git a/docs/06-troubleshooting/05-recon.md
b/docs/06-troubleshooting/05-recon.md
new file mode 100644
index 00000000..7071f4d5
--- /dev/null
+++ b/docs/06-troubleshooting/05-recon.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Recon
+---
+
+# Troubleshooting Recon
+
+**TODO:** File a subtask under
[HDDS-9860](https://issues.apache.org/jira/browse/HDDS-9860) and complete this
page or section.
+
diff --git a/docs/06-troubleshooting/06-performance.md
b/docs/06-troubleshooting/06-performance.md
new file mode 100644
index 00000000..9e255d78
--- /dev/null
+++ b/docs/06-troubleshooting/06-performance.md
@@ -0,0 +1,10 @@
+---
+sidebar_label: Performance
+---
+
+# Troubleshooting Performance
+
+**TODO:** File a subtask under
[HDDS-9860](https://issues.apache.org/jira/browse/HDDS-9860) and complete this
page or section.
+
+This may need to be converted into a subsection with multiple pages under it.
+
diff --git a/docs/06-troubleshooting/07-integrations/_category_.yml
b/docs/06-troubleshooting/07-integrations/_category_.yml
new file mode 100644
index 00000000..08b3b4a1
--- /dev/null
+++ b/docs/06-troubleshooting/07-integrations/_category_.yml
@@ -0,0 +1 @@
+label: Integrations
diff --git a/docs/06-troubleshooting/07-integrations/placeholder.md
b/docs/06-troubleshooting/07-integrations/placeholder.md
new file mode 100644
index 00000000..a4e56f3f
--- /dev/null
+++ b/docs/06-troubleshooting/07-integrations/placeholder.md
@@ -0,0 +1,6 @@
+# PLACEHOLDER
+
+**TODO:** File a subtask under
[HDDS-9860](https://issues.apache.org/jira/browse/HDDS-9860) and complete this
page or section.
+
+Add pages under this section for troubleshooting Ozone integration with
various components like Spark.
+
diff --git a/docs/06-troubleshooting/08-security/01-certificates.md
b/docs/06-troubleshooting/08-security/01-certificates.md
new file mode 100644
index 00000000..fda29e56
--- /dev/null
+++ b/docs/06-troubleshooting/08-security/01-certificates.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Certificates
+---
+
+# Troubleshooting Certificates
+
+**TODO:** File a subtask under
[HDDS-9860](https://issues.apache.org/jira/browse/HDDS-9860) and complete this
page or section.
+
diff --git a/docs/06-troubleshooting/08-security/02-authentication.md
b/docs/06-troubleshooting/08-security/02-authentication.md
new file mode 100644
index 00000000..94f596bf
--- /dev/null
+++ b/docs/06-troubleshooting/08-security/02-authentication.md
@@ -0,0 +1,14 @@
+---
+sidebar_label: Authentication
+---
+
+# Authentication
+
+**TODO:** File a subtask under
[HDDS-9860](https://issues.apache.org/jira/browse/HDDS-9860) and complete this
page or section.
+
+## Kerberos
+
+## SPNEGO
+
+## S3 Credentials
+
diff --git a/docs/06-troubleshooting/08-security/03-authorization.md
b/docs/06-troubleshooting/08-security/03-authorization.md
new file mode 100644
index 00000000..6d10b460
--- /dev/null
+++ b/docs/06-troubleshooting/08-security/03-authorization.md
@@ -0,0 +1,14 @@
+---
+sidebar_label: Authorization
+---
+
+# Troubleshooting Authorization
+
+**TODO:** File a subtask under
[HDDS-9860](https://issues.apache.org/jira/browse/HDDS-9860) and complete this
page or section.
+
+## Ranger ACLs
+
+## Native ACLs
+
+## Ozone Administrator Priviledges
+
diff --git a/docs/06-troubleshooting/08-security/_category_.yml
b/docs/06-troubleshooting/08-security/_category_.yml
new file mode 100644
index 00000000..76a1b343
--- /dev/null
+++ b/docs/06-troubleshooting/08-security/_category_.yml
@@ -0,0 +1 @@
+label: Security
diff --git a/docs/06-troubleshooting/09-upgrade-downgrade.md
b/docs/06-troubleshooting/09-upgrade-downgrade.md
new file mode 100644
index 00000000..48ef383d
--- /dev/null
+++ b/docs/06-troubleshooting/09-upgrade-downgrade.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Upgrades and Downgrades
+---
+
+# Troubleshooting Upgrades and Downgrades
+
+**TODO:** File a subtask under
[HDDS-9860](https://issues.apache.org/jira/browse/HDDS-9860) and complete this
page or section.
+
diff --git a/docs/06-troubleshooting/10-decommission-maintenance.md
b/docs/06-troubleshooting/10-decommission-maintenance.md
new file mode 100644
index 00000000..187c8b84
--- /dev/null
+++ b/docs/06-troubleshooting/10-decommission-maintenance.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Decommissioning and Maintenance
+---
+
+# Troubleshooting Decommissioning and Maintenance
+
+**TODO:** File a subtask under
[HDDS-9860](https://issues.apache.org/jira/browse/HDDS-9860) and complete this
page or section.
+
diff --git a/docs/06-troubleshooting/11-write-pipelines.md
b/docs/06-troubleshooting/11-write-pipelines.md
new file mode 100644
index 00000000..6ea43bbb
--- /dev/null
+++ b/docs/06-troubleshooting/11-write-pipelines.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Write Pipelines
+---
+
+# Troubleshooting Write Pipelines
+
+**TODO:** File a subtask under
[HDDS-9860](https://issues.apache.org/jira/browse/HDDS-9860) and complete this
page or section.
+
diff --git a/docs/06-troubleshooting/12-storage-containers.md
b/docs/06-troubleshooting/12-storage-containers.md
new file mode 100644
index 00000000..cf283ab0
--- /dev/null
+++ b/docs/06-troubleshooting/12-storage-containers.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Storage Containers
+---
+
+# Troubleshooting Storage Containers
+
+**TODO:** File a subtask under
[HDDS-9860](https://issues.apache.org/jira/browse/HDDS-9860) and complete this
page or section.
+
diff --git a/docs/06-troubleshooting/13-ratis.md
b/docs/06-troubleshooting/13-ratis.md
new file mode 100644
index 00000000..0671a516
--- /dev/null
+++ b/docs/06-troubleshooting/13-ratis.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Ratis
+---
+
+# Troubleshooting Ratis
+
+**TODO:** File a subtask under
[HDDS-9860](https://issues.apache.org/jira/browse/HDDS-9860) and complete this
page or section.
+
diff --git a/docs/06-troubleshooting/14-rocksdb.md
b/docs/06-troubleshooting/14-rocksdb.md
new file mode 100644
index 00000000..832bc880
--- /dev/null
+++ b/docs/06-troubleshooting/14-rocksdb.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: RocksDB
+---
+
+# Troubleshooting RocksDB
+
+**TODO:** File a subtask under
[HDDS-9860](https://issues.apache.org/jira/browse/HDDS-9860) and complete this
page or section.
+
diff --git a/docs/06-troubleshooting/_category_.yml
b/docs/06-troubleshooting/_category_.yml
new file mode 100644
index 00000000..ff677b93
--- /dev/null
+++ b/docs/06-troubleshooting/_category_.yml
@@ -0,0 +1 @@
+label: Troubleshooting
diff --git
a/docs/07-system-internals/01-components/01-ozone-manager/01-disk-layout.md
b/docs/07-system-internals/01-components/01-ozone-manager/01-disk-layout.md
new file mode 100644
index 00000000..ec034d6a
--- /dev/null
+++ b/docs/07-system-internals/01-components/01-ozone-manager/01-disk-layout.md
@@ -0,0 +1,6 @@
+---
+sidebar_label: Disk Layout
+---
+# Ozone Manager Disk Layout
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
diff --git
a/docs/07-system-internals/01-components/01-ozone-manager/02-rocksdb-schema.md
b/docs/07-system-internals/01-components/01-ozone-manager/02-rocksdb-schema.md
new file mode 100644
index 00000000..bd794e5b
--- /dev/null
+++
b/docs/07-system-internals/01-components/01-ozone-manager/02-rocksdb-schema.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: RocksDB Schema
+---
+
+# Ozone Manager RocksDB Schema
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/01-components/01-ozone-manager/03-in-memory-storage.md
b/docs/07-system-internals/01-components/01-ozone-manager/03-in-memory-storage.md
new file mode 100644
index 00000000..6ce55afb
--- /dev/null
+++
b/docs/07-system-internals/01-components/01-ozone-manager/03-in-memory-storage.md
@@ -0,0 +1,12 @@
+---
+sidebar_label: In-Memory Storage
+---
+
+# Ozone Manager In-Memory Storage
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+- Volume and bucket tables
+- RocksDB block cache
+- Container cache
+
diff --git
a/docs/07-system-internals/01-components/01-ozone-manager/04-startup-sequence.md
b/docs/07-system-internals/01-components/01-ozone-manager/04-startup-sequence.md
new file mode 100644
index 00000000..f66f8add
--- /dev/null
+++
b/docs/07-system-internals/01-components/01-ozone-manager/04-startup-sequence.md
@@ -0,0 +1,9 @@
+---
+sidebar_label: Startup Sequence
+---
+
+# Ozone Manager Startup Sequence
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+
diff --git
a/docs/07-system-internals/01-components/01-ozone-manager/05-roles.md
b/docs/07-system-internals/01-components/01-ozone-manager/05-roles.md
new file mode 100644
index 00000000..5f9c85e6
--- /dev/null
+++ b/docs/07-system-internals/01-components/01-ozone-manager/05-roles.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Roles
+---
+
+# Ozone Manager Roles
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/01-components/01-ozone-manager/06-write-request-flow.md
b/docs/07-system-internals/01-components/01-ozone-manager/06-write-request-flow.md
new file mode 100644
index 00000000..08e2c2cd
--- /dev/null
+++
b/docs/07-system-internals/01-components/01-ozone-manager/06-write-request-flow.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Write Request Flow
+---
+
+# Ozone Manager Write Request Flow
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/01-components/01-ozone-manager/07-read-request-flow.md
b/docs/07-system-internals/01-components/01-ozone-manager/07-read-request-flow.md
new file mode 100644
index 00000000..b6d86a4e
--- /dev/null
+++
b/docs/07-system-internals/01-components/01-ozone-manager/07-read-request-flow.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Read Request Flow
+---
+
+# Ozone Manager Read Request Flow
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/01-components/01-ozone-manager/_category_.yml
b/docs/07-system-internals/01-components/01-ozone-manager/_category_.yml
new file mode 100644
index 00000000..cfe73022
--- /dev/null
+++ b/docs/07-system-internals/01-components/01-ozone-manager/_category_.yml
@@ -0,0 +1 @@
+label: Ozone Manager
diff --git
a/docs/07-system-internals/01-components/02-storage-container-manager/01-disk-layout.md
b/docs/07-system-internals/01-components/02-storage-container-manager/01-disk-layout.md
new file mode 100644
index 00000000..7b7c655f
--- /dev/null
+++
b/docs/07-system-internals/01-components/02-storage-container-manager/01-disk-layout.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Disk Layout
+---
+
+# Storage Container Manager Disk Layout
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/01-components/02-storage-container-manager/02-rocksdb-schema.md
b/docs/07-system-internals/01-components/02-storage-container-manager/02-rocksdb-schema.md
new file mode 100644
index 00000000..ec1a522b
--- /dev/null
+++
b/docs/07-system-internals/01-components/02-storage-container-manager/02-rocksdb-schema.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: RocksDB Schema
+---
+
+# Storage Container Manager RocksDB Schema
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/01-components/02-storage-container-manager/03-in-memory-storage.md
b/docs/07-system-internals/01-components/02-storage-container-manager/03-in-memory-storage.md
new file mode 100644
index 00000000..4867f4ed
--- /dev/null
+++
b/docs/07-system-internals/01-components/02-storage-container-manager/03-in-memory-storage.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: In-Memory Storage
+---
+
+# Storage Container Manager In-Memory Storage
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/01-components/02-storage-container-manager/04-startup-sequence.md
b/docs/07-system-internals/01-components/02-storage-container-manager/04-startup-sequence.md
new file mode 100644
index 00000000..14880e06
--- /dev/null
+++
b/docs/07-system-internals/01-components/02-storage-container-manager/04-startup-sequence.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Startup Sequence
+---
+
+# Storage Container Manager Startup Sequence
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/01-components/02-storage-container-manager/05-roles.md
b/docs/07-system-internals/01-components/02-storage-container-manager/05-roles.md
new file mode 100644
index 00000000..c9adb500
--- /dev/null
+++
b/docs/07-system-internals/01-components/02-storage-container-manager/05-roles.md
@@ -0,0 +1,10 @@
+---
+sidebar_label: Roles
+---
+
+# Storage Container Manager Roles
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+- Leader makes wrtes to state and updates followers based on datanode reports.
+
diff --git
a/docs/07-system-internals/01-components/02-storage-container-manager/06-admin-write-request-flow.md
b/docs/07-system-internals/01-components/02-storage-container-manager/06-admin-write-request-flow.md
new file mode 100644
index 00000000..cc48d348
--- /dev/null
+++
b/docs/07-system-internals/01-components/02-storage-container-manager/06-admin-write-request-flow.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Admin Write Request Flow
+---
+
+# Storage Container Manager Admin Write Request flow
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/01-components/02-storage-container-manager/07-admin-read-request-flow.md
b/docs/07-system-internals/01-components/02-storage-container-manager/07-admin-read-request-flow.md
new file mode 100644
index 00000000..8e16fcb5
--- /dev/null
+++
b/docs/07-system-internals/01-components/02-storage-container-manager/07-admin-read-request-flow.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Admin Read Request Flow
+---
+
+# Storage Container Manager Admin Read Request Flow
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/01-components/02-storage-container-manager/_category_.yml
b/docs/07-system-internals/01-components/02-storage-container-manager/_category_.yml
new file mode 100644
index 00000000..394a949e
--- /dev/null
+++
b/docs/07-system-internals/01-components/02-storage-container-manager/_category_.yml
@@ -0,0 +1 @@
+label: Storage Container Manager
diff --git
a/docs/07-system-internals/01-components/03-datanode/01-disk-layout.md
b/docs/07-system-internals/01-components/03-datanode/01-disk-layout.md
new file mode 100644
index 00000000..42079ae4
--- /dev/null
+++ b/docs/07-system-internals/01-components/03-datanode/01-disk-layout.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Disk Layout
+---
+
+# Datanode Disk Layout
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/01-components/03-datanode/02-rocksdb-schema.md
b/docs/07-system-internals/01-components/03-datanode/02-rocksdb-schema.md
new file mode 100644
index 00000000..0f95d3dc
--- /dev/null
+++ b/docs/07-system-internals/01-components/03-datanode/02-rocksdb-schema.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: RocksDB Layout
+---
+
+# Datanode RocksDB Schema
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/01-components/03-datanode/03-in-memory-storage.md
b/docs/07-system-internals/01-components/03-datanode/03-in-memory-storage.md
new file mode 100644
index 00000000..95a53a68
--- /dev/null
+++ b/docs/07-system-internals/01-components/03-datanode/03-in-memory-storage.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: In-Memory Storage
+---
+
+# Datanode In-Memory Storage
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/01-components/03-datanode/04-startup-sequence.md
b/docs/07-system-internals/01-components/03-datanode/04-startup-sequence.md
new file mode 100644
index 00000000..502ac1dd
--- /dev/null
+++ b/docs/07-system-internals/01-components/03-datanode/04-startup-sequence.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Startup Sequence
+---
+
+# Datanode Startup Sequence
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/01-components/03-datanode/06-write-request-flow.md
b/docs/07-system-internals/01-components/03-datanode/06-write-request-flow.md
new file mode 100644
index 00000000..8dd02ff2
--- /dev/null
+++
b/docs/07-system-internals/01-components/03-datanode/06-write-request-flow.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Write Request Flow
+---
+
+# Datanode Write Request Flow
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/01-components/03-datanode/07-read-request-flow.md
b/docs/07-system-internals/01-components/03-datanode/07-read-request-flow.md
new file mode 100644
index 00000000..b4250fa9
--- /dev/null
+++ b/docs/07-system-internals/01-components/03-datanode/07-read-request-flow.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Read Request Flow
+---
+
+# Datanode Read Request Flow
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git a/docs/07-system-internals/01-components/03-datanode/_category_.yml
b/docs/07-system-internals/01-components/03-datanode/_category_.yml
new file mode 100644
index 00000000..1d962cd3
--- /dev/null
+++ b/docs/07-system-internals/01-components/03-datanode/_category_.yml
@@ -0,0 +1 @@
+label: Datanode
diff --git a/docs/07-system-internals/01-components/04-recon/01-disk-layout.md
b/docs/07-system-internals/01-components/04-recon/01-disk-layout.md
new file mode 100644
index 00000000..fd8186a6
--- /dev/null
+++ b/docs/07-system-internals/01-components/04-recon/01-disk-layout.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Disk Layout
+---
+
+# Recon Disk Layout
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/01-components/04-recon/02-rocksdb-schema.md
b/docs/07-system-internals/01-components/04-recon/02-rocksdb-schema.md
new file mode 100644
index 00000000..6088728b
--- /dev/null
+++ b/docs/07-system-internals/01-components/04-recon/02-rocksdb-schema.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: RocksDB Layout
+---
+
+# RocksDB Layout
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git a/docs/07-system-internals/01-components/04-recon/03-sql-schema.md
b/docs/07-system-internals/01-components/04-recon/03-sql-schema.md
new file mode 100644
index 00000000..92634d5b
--- /dev/null
+++ b/docs/07-system-internals/01-components/04-recon/03-sql-schema.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: SQL Schema
+---
+
+# SQL Schema
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/01-components/04-recon/04-in-memory-storage.md
b/docs/07-system-internals/01-components/04-recon/04-in-memory-storage.md
new file mode 100644
index 00000000..3372ba4d
--- /dev/null
+++ b/docs/07-system-internals/01-components/04-recon/04-in-memory-storage.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: In-Memory Storage
+---
+
+# Recon In-Memory Storage
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/01-components/04-recon/05-startup-sequence.md
b/docs/07-system-internals/01-components/04-recon/05-startup-sequence.md
new file mode 100644
index 00000000..1397ee9a
--- /dev/null
+++ b/docs/07-system-internals/01-components/04-recon/05-startup-sequence.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Startup Sequence
+---
+
+# Recon Startup Sequence
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/01-components/04-recon/06-syncing-data-from-om.md
b/docs/07-system-internals/01-components/04-recon/06-syncing-data-from-om.md
new file mode 100644
index 00000000..7fd9c991
--- /dev/null
+++ b/docs/07-system-internals/01-components/04-recon/06-syncing-data-from-om.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Syncing Data From Ozone Manager
+---
+
+# How Recon Syncs Data From Ozone Manager
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/01-components/04-recon/07-syncing-data-from-scm.md
b/docs/07-system-internals/01-components/04-recon/07-syncing-data-from-scm.md
new file mode 100644
index 00000000..eac7c7ee
--- /dev/null
+++
b/docs/07-system-internals/01-components/04-recon/07-syncing-data-from-scm.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Syncing Data From Storage Container Manager
+---
+
+# How Recon Syncs Data From Storage Container Manager
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/01-components/04-recon/08-syncing-data-from-datanodes.md
b/docs/07-system-internals/01-components/04-recon/08-syncing-data-from-datanodes.md
new file mode 100644
index 00000000..5059994a
--- /dev/null
+++
b/docs/07-system-internals/01-components/04-recon/08-syncing-data-from-datanodes.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Syncing Data From Datanodes
+---
+
+# How Recon Syncs Data From Datanodes
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git a/docs/07-system-internals/01-components/04-recon/_category_.yml
b/docs/07-system-internals/01-components/04-recon/_category_.yml
new file mode 100644
index 00000000..3b40c251
--- /dev/null
+++ b/docs/07-system-internals/01-components/04-recon/_category_.yml
@@ -0,0 +1 @@
+label: Recon
diff --git
a/docs/07-system-internals/01-components/05-s3-gateway/01-overview.md
b/docs/07-system-internals/01-components/05-s3-gateway/01-overview.md
new file mode 100644
index 00000000..caf4dd4c
--- /dev/null
+++ b/docs/07-system-internals/01-components/05-s3-gateway/01-overview.md
@@ -0,0 +1,14 @@
+---
+sidebar_label: Overview
+---
+
+# S3 Gateway Overview
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+- Stateless
+- Converts REST calls to Ozone client calls
+- No startup steps
+- No disk state
+- Persistent client connections
+
diff --git
a/docs/07-system-internals/01-components/05-s3-gateway/02-request-flow.md
b/docs/07-system-internals/01-components/05-s3-gateway/02-request-flow.md
new file mode 100644
index 00000000..01d0abc4
--- /dev/null
+++ b/docs/07-system-internals/01-components/05-s3-gateway/02-request-flow.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Request Flow
+---
+
+# S3 Gateway Request flow
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/01-components/05-s3-gateway/_category_.yml
b/docs/07-system-internals/01-components/05-s3-gateway/_category_.yml
new file mode 100644
index 00000000..d65d10bc
--- /dev/null
+++ b/docs/07-system-internals/01-components/05-s3-gateway/_category_.yml
@@ -0,0 +1 @@
+label: S3 Gateway
diff --git
a/docs/07-system-internals/01-components/06-client/01-startup-sequence.md
b/docs/07-system-internals/01-components/06-client/01-startup-sequence.md
new file mode 100644
index 00000000..e62b63ab
--- /dev/null
+++ b/docs/07-system-internals/01-components/06-client/01-startup-sequence.md
@@ -0,0 +1,11 @@
+---
+sidebar_label: Startup Sequence
+---
+
+# Client Startup Sequence
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+- Ozone shell script invokes the correct jar.
+- Client makes `getServiceInfo` call to Ozone Manager.
+
diff --git
a/docs/07-system-internals/01-components/06-client/02-in-memory-storage.md
b/docs/07-system-internals/01-components/06-client/02-in-memory-storage.md
new file mode 100644
index 00000000..492f671c
--- /dev/null
+++ b/docs/07-system-internals/01-components/06-client/02-in-memory-storage.md
@@ -0,0 +1,11 @@
+---
+sidebar_label: In-Memory Storage
+---
+
+# Ozone Client In-Memory Storage
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+- Info the client saves after the get service info call.
+- Ratis client cache, current OM leader.
+
diff --git a/docs/07-system-internals/01-components/06-client/03-jars.md
b/docs/07-system-internals/01-components/06-client/03-jars.md
new file mode 100644
index 00000000..0bef3577
--- /dev/null
+++ b/docs/07-system-internals/01-components/06-client/03-jars.md
@@ -0,0 +1,9 @@
+---
+sidebar_label: Jars
+---
+
+# Client Jars
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+Explain how HDFS client is able to use Ozone by adding the fat client to the
classpath, providing different inplementations for the `FileSystem` interface
methods.
diff --git a/docs/07-system-internals/01-components/06-client/_category_.yml
b/docs/07-system-internals/01-components/06-client/_category_.yml
new file mode 100644
index 00000000..8999223b
--- /dev/null
+++ b/docs/07-system-internals/01-components/06-client/_category_.yml
@@ -0,0 +1 @@
+label: Client
diff --git a/docs/07-system-internals/01-components/_category_.yml
b/docs/07-system-internals/01-components/_category_.yml
new file mode 100644
index 00000000..93fd4ef9
--- /dev/null
+++ b/docs/07-system-internals/01-components/_category_.yml
@@ -0,0 +1 @@
+label: Components
diff --git a/docs/07-system-internals/02-data-operations/01-write.md
b/docs/07-system-internals/02-data-operations/01-write.md
new file mode 100644
index 00000000..d283bc1b
--- /dev/null
+++ b/docs/07-system-internals/02-data-operations/01-write.md
@@ -0,0 +1,36 @@
+---
+sidebar_label: Write
+---
+
+# Implementation of Write Operations
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+## Writing Metadata
+
+## Writing Data
+
+Trace every part of a write request from beginning to end. This includes:
+- Client getting encryption keys
+- Client calling OM to create key
+- OM validating client's Kerberos principle
+- OM checking permissions (Ranger or Native ACLs)
+- OM allocating blocks from SCM
+- OM creating open key
+ - Mention open key cleanup service, and that if key is not comitted within
a given time it will be picked up for [deletion](./delete#deleting-data)
+- OM generating block tokens from the shared secret previously retreived from
SCM
+- OM returning container, blocks, pipeline, block tokens
+- Client sending checksums and datanodes validating
+- Client sending block tokens and datanode validating based on the shared
secret from SCM
+- Client sending write chunk and put block requests to the datanodes
+ - For Ratis:
+ - Include topology choices of which datanodes to use
+ - Include failover handling
+ - For [EC](../features/erasure-coding) and [Ratis
Streaming](../features/ratis-streaming), link to their feature pages.
+- Client allocating more blocks if needed
+- Client committing to OM
+- OM checking the current namepsace
+ - Bucket must still exist
+ - Existing key will be overwritten
+- OM committing the data and returning to the client
+
diff --git a/docs/07-system-internals/02-data-operations/02-read.md
b/docs/07-system-internals/02-data-operations/02-read.md
new file mode 100644
index 00000000..a806a3e6
--- /dev/null
+++ b/docs/07-system-internals/02-data-operations/02-read.md
@@ -0,0 +1,28 @@
+---
+sidebar_label: Read
+---
+
+# Implementation of Read Operations
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+## Reading Metadata
+
+## Reading Data
+
+Trace every part of a read request from beginning to end. This includes:
+- Client getting encryption keys
+- Client calling OM to create key
+- OM validating client's Kerberos princiapl
+- OM checking permissions (Ranger or Native ACLs)
+- OM generating block tokens from the shared secret previously retreived from
SCM
+- OM getting block locations from SCM or from its cache.
+- OM returning container, blocks, pipeline, block tokens
+- Client sending block tokens and datanode validating based on the shared
secret from SCM
+- Client sending read chunk requests to datanode to fetch the data.
+ - For replication:
+ - Include topology choices of which datanodes to use
+ - Include failover handling
+ - For EC, link to the [EC feature page](../features/erasure-coding).
+- Client validating checksums
+
diff --git a/docs/07-system-internals/02-data-operations/03-delete.md
b/docs/07-system-internals/02-data-operations/03-delete.md
new file mode 100644
index 00000000..1ea4862f
--- /dev/null
+++ b/docs/07-system-internals/02-data-operations/03-delete.md
@@ -0,0 +1,25 @@
+---
+sidebar_label: Delete
+---
+
+# Implementation of Delete Operations
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+## Deleting Metadata
+
+## Deleting Data
+
+Trace every part of a delete request from beginning to end. This includes:
+- Client getting encryption keys
+- Client calling OM to delete the key
+- OM validating client's Kerberos princiapl
+- OM checking permissions (Ranger or Native ACLs)
+- OM marking the key for deletion and removing it from the namespace.
+- OM acking to the client
+- OM sending blocks to delete to SCM
+- SCM sending blocks to delete to the datanode
+- Datanode removes data
+
+Note that delete works the same regardless of replication type. Also document
timing of background services and their batch size to estimate the rate of
deletion.
+
diff --git a/docs/07-system-internals/02-data-operations/04-hsync.md
b/docs/07-system-internals/02-data-operations/04-hsync.md
new file mode 100644
index 00000000..4c1b5f40
--- /dev/null
+++ b/docs/07-system-internals/02-data-operations/04-hsync.md
@@ -0,0 +1,14 @@
+---
+# Page is accessible by direct link only in production site builds. It can be
included in the sidebar when the feature is complete.
+unlisted: true
+sidebar_label: HFlush and HSync
+---
+
+# Implementation of HFlush and HSync
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+## HFlush
+
+## HSync
+
diff --git a/docs/07-system-internals/02-data-operations/_category_.yml
b/docs/07-system-internals/02-data-operations/_category_.yml
new file mode 100644
index 00000000..bdf7b506
--- /dev/null
+++ b/docs/07-system-internals/02-data-operations/_category_.yml
@@ -0,0 +1 @@
+label: Data Operations
diff --git a/docs/07-system-internals/03-data-integrity/01-checksums.md
b/docs/07-system-internals/03-data-integrity/01-checksums.md
new file mode 100644
index 00000000..261734b7
--- /dev/null
+++ b/docs/07-system-internals/03-data-integrity/01-checksums.md
@@ -0,0 +1,10 @@
+---
+sidebar_label: Checksums
+---
+
+# Checksum System Internals
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+Document the internal implementations of read and write checksums for chunks
and stripes.
+
diff --git a/docs/07-system-internals/03-data-integrity/02-container-scanner.md
b/docs/07-system-internals/03-data-integrity/02-container-scanner.md
new file mode 100644
index 00000000..5cca2a7a
--- /dev/null
+++ b/docs/07-system-internals/03-data-integrity/02-container-scanner.md
@@ -0,0 +1,4 @@
+# Datanode Container Scanner
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git a/docs/07-system-internals/03-data-integrity/03-volume-scanner.md
b/docs/07-system-internals/03-data-integrity/03-volume-scanner.md
new file mode 100644
index 00000000..91a945ce
--- /dev/null
+++ b/docs/07-system-internals/03-data-integrity/03-volume-scanner.md
@@ -0,0 +1,4 @@
+# Datanode Volume Scanner
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git a/docs/07-system-internals/03-data-integrity/_category_.yml
b/docs/07-system-internals/03-data-integrity/_category_.yml
new file mode 100644
index 00000000..cb84fad5
--- /dev/null
+++ b/docs/07-system-internals/03-data-integrity/_category_.yml
@@ -0,0 +1 @@
+label: Data Integrity
diff --git a/docs/07-system-internals/04-replication/01-metadata-replication.md
b/docs/07-system-internals/04-replication/01-metadata-replication.md
new file mode 100644
index 00000000..66105176
--- /dev/null
+++ b/docs/07-system-internals/04-replication/01-metadata-replication.md
@@ -0,0 +1,5 @@
+# Metadata Replication
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+Document how OM and SCM replicate data using Ratis. This includes individual
append entries requests and snapshot installs for lagging followers.
diff --git
a/docs/07-system-internals/04-replication/02-data-replication/01-write-pipelines/01-overview.md
b/docs/07-system-internals/04-replication/02-data-replication/01-write-pipelines/01-overview.md
new file mode 100644
index 00000000..fb9f780b
--- /dev/null
+++
b/docs/07-system-internals/04-replication/02-data-replication/01-write-pipelines/01-overview.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Overview
+---
+
+# Write Pipeline Overview
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/04-replication/02-data-replication/01-write-pipelines/02-types.md
b/docs/07-system-internals/04-replication/02-data-replication/01-write-pipelines/02-types.md
new file mode 100644
index 00000000..2ba7c96c
--- /dev/null
+++
b/docs/07-system-internals/04-replication/02-data-replication/01-write-pipelines/02-types.md
@@ -0,0 +1,10 @@
+---
+sidebar_label: Types
+---
+
+# Types of Write Pipelines
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+Document differences in Ratis, EC, and Standalone write pipelines.
+
diff --git
a/docs/07-system-internals/04-replication/02-data-replication/01-write-pipelines/03-states.md
b/docs/07-system-internals/04-replication/02-data-replication/01-write-pipelines/03-states.md
new file mode 100644
index 00000000..8f316319
--- /dev/null
+++
b/docs/07-system-internals/04-replication/02-data-replication/01-write-pipelines/03-states.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: States
+---
+
+# Write Pipeline States
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/04-replication/02-data-replication/01-write-pipelines/04-reports.md
b/docs/07-system-internals/04-replication/02-data-replication/01-write-pipelines/04-reports.md
new file mode 100644
index 00000000..4c1bd119
--- /dev/null
+++
b/docs/07-system-internals/04-replication/02-data-replication/01-write-pipelines/04-reports.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Reports
+---
+
+# Write Pipeline Reports
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/04-replication/02-data-replication/01-write-pipelines/05-creation.md
b/docs/07-system-internals/04-replication/02-data-replication/01-write-pipelines/05-creation.md
new file mode 100644
index 00000000..e2e60df0
--- /dev/null
+++
b/docs/07-system-internals/04-replication/02-data-replication/01-write-pipelines/05-creation.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Creation
+---
+
+# Write Pipeline Creation
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/04-replication/02-data-replication/01-write-pipelines/06-persistence.md
b/docs/07-system-internals/04-replication/02-data-replication/01-write-pipelines/06-persistence.md
new file mode 100644
index 00000000..308f17cf
--- /dev/null
+++
b/docs/07-system-internals/04-replication/02-data-replication/01-write-pipelines/06-persistence.md
@@ -0,0 +1,10 @@
+---
+sidebar_label: Persistence
+---
+
+# Write Pipeline Persistence
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+Document how write pipelines are persisted on SCM and Datanodes and re-used on
restart.
+
diff --git
a/docs/07-system-internals/04-replication/02-data-replication/01-write-pipelines/07-destruction.md
b/docs/07-system-internals/04-replication/02-data-replication/01-write-pipelines/07-destruction.md
new file mode 100644
index 00000000..a2ce78f6
--- /dev/null
+++
b/docs/07-system-internals/04-replication/02-data-replication/01-write-pipelines/07-destruction.md
@@ -0,0 +1,10 @@
+---
+sidebar_label: Destruction
+---
+
+# Write Pipeline Destruction
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+Document conditions that can cause a write pipeline to be closed, and what
steps are taken when this happens.
+
diff --git
a/docs/07-system-internals/04-replication/02-data-replication/01-write-pipelines/_category_.yml
b/docs/07-system-internals/04-replication/02-data-replication/01-write-pipelines/_category_.yml
new file mode 100644
index 00000000..abaaba69
--- /dev/null
+++
b/docs/07-system-internals/04-replication/02-data-replication/01-write-pipelines/_category_.yml
@@ -0,0 +1 @@
+label: Write Pipelines
diff --git
a/docs/07-system-internals/04-replication/02-data-replication/02-containers/01-overview.md
b/docs/07-system-internals/04-replication/02-data-replication/02-containers/01-overview.md
new file mode 100644
index 00000000..3babdaf9
--- /dev/null
+++
b/docs/07-system-internals/04-replication/02-data-replication/02-containers/01-overview.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Overview
+---
+
+# Containers Overview
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/04-replication/02-data-replication/02-containers/02-types.md
b/docs/07-system-internals/04-replication/02-data-replication/02-containers/02-types.md
new file mode 100644
index 00000000..510e5dff
--- /dev/null
+++
b/docs/07-system-internals/04-replication/02-data-replication/02-containers/02-types.md
@@ -0,0 +1,10 @@
+---
+sidebar_label: Types
+---
+
+# Types of Containers
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+Document differences in Ratis, EC (data and parity), and Standalone containers.
+
diff --git
a/docs/07-system-internals/04-replication/02-data-replication/02-containers/03-states.md
b/docs/07-system-internals/04-replication/02-data-replication/02-containers/03-states.md
new file mode 100644
index 00000000..edbfdf3d
--- /dev/null
+++
b/docs/07-system-internals/04-replication/02-data-replication/02-containers/03-states.md
@@ -0,0 +1,10 @@
+---
+sidebar_label: States
+---
+
+# Container States
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+Document container states in SCM and replicas.
+
diff --git
a/docs/07-system-internals/04-replication/02-data-replication/02-containers/04-reports.md
b/docs/07-system-internals/04-replication/02-data-replication/02-containers/04-reports.md
new file mode 100644
index 00000000..532d6e07
--- /dev/null
+++
b/docs/07-system-internals/04-replication/02-data-replication/02-containers/04-reports.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Reports
+---
+
+# Container Reports
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/04-replication/02-data-replication/02-containers/05-creation.md
b/docs/07-system-internals/04-replication/02-data-replication/02-containers/05-creation.md
new file mode 100644
index 00000000..2d43153a
--- /dev/null
+++
b/docs/07-system-internals/04-replication/02-data-replication/02-containers/05-creation.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Creation
+---
+
+# Container Creation
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/04-replication/02-data-replication/02-containers/06-persistence.md
b/docs/07-system-internals/04-replication/02-data-replication/02-containers/06-persistence.md
new file mode 100644
index 00000000..f56a02a1
--- /dev/null
+++
b/docs/07-system-internals/04-replication/02-data-replication/02-containers/06-persistence.md
@@ -0,0 +1,10 @@
+---
+sidebar_label: Persistence
+---
+
+# Container Persistence
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+Document how write containers are persisted on SCM and Datanodes and re-used
on restart.
+
diff --git
a/docs/07-system-internals/04-replication/02-data-replication/02-containers/07-destruction.md
b/docs/07-system-internals/04-replication/02-data-replication/02-containers/07-destruction.md
new file mode 100644
index 00000000..56f4203e
--- /dev/null
+++
b/docs/07-system-internals/04-replication/02-data-replication/02-containers/07-destruction.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Deletion
+---
+
+# Container Deletion
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git
a/docs/07-system-internals/04-replication/02-data-replication/02-containers/08-replication.md
b/docs/07-system-internals/04-replication/02-data-replication/02-containers/08-replication.md
new file mode 100644
index 00000000..17a83d40
--- /dev/null
+++
b/docs/07-system-internals/04-replication/02-data-replication/02-containers/08-replication.md
@@ -0,0 +1,9 @@
+---
+sidebar_label: Replication
+---
+
+# Container Replication
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+Document replication process among datanodes. Advantages of push replication
and cases where an EC container can be replicated, like decommissioning.
diff --git
a/docs/07-system-internals/04-replication/02-data-replication/02-containers/09-offline-reconstruction.md
b/docs/07-system-internals/04-replication/02-data-replication/02-containers/09-offline-reconstruction.md
new file mode 100644
index 00000000..2fea3bc9
--- /dev/null
+++
b/docs/07-system-internals/04-replication/02-data-replication/02-containers/09-offline-reconstruction.md
@@ -0,0 +1,10 @@
+---
+sidebar_label: Reconstruction
+---
+
+# Container Reconstruction
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+Document EC offline reconstruction process.
+
diff --git
a/docs/07-system-internals/04-replication/02-data-replication/02-containers/_category_.yml
b/docs/07-system-internals/04-replication/02-data-replication/02-containers/_category_.yml
new file mode 100644
index 00000000..8909b2ef
--- /dev/null
+++
b/docs/07-system-internals/04-replication/02-data-replication/02-containers/_category_.yml
@@ -0,0 +1 @@
+label: Containers
diff --git
a/docs/07-system-internals/04-replication/02-data-replication/03-replication-manager.md
b/docs/07-system-internals/04-replication/02-data-replication/03-replication-manager.md
new file mode 100644
index 00000000..615c872f
--- /dev/null
+++
b/docs/07-system-internals/04-replication/02-data-replication/03-replication-manager.md
@@ -0,0 +1,3 @@
+# SCM Replication Manager
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
diff --git
a/docs/07-system-internals/04-replication/02-data-replication/04-container-balancer.md
b/docs/07-system-internals/04-replication/02-data-replication/04-container-balancer.md
new file mode 100644
index 00000000..1e76d843
--- /dev/null
+++
b/docs/07-system-internals/04-replication/02-data-replication/04-container-balancer.md
@@ -0,0 +1,3 @@
+# SCM Container Balancer
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
diff --git
a/docs/07-system-internals/04-replication/02-data-replication/_category_.yml
b/docs/07-system-internals/04-replication/02-data-replication/_category_.yml
new file mode 100644
index 00000000..dd6353b4
--- /dev/null
+++ b/docs/07-system-internals/04-replication/02-data-replication/_category_.yml
@@ -0,0 +1 @@
+label: Data Replication
diff --git a/docs/07-system-internals/04-replication/_category_.yml
b/docs/07-system-internals/04-replication/_category_.yml
new file mode 100644
index 00000000..7fbd19da
--- /dev/null
+++ b/docs/07-system-internals/04-replication/_category_.yml
@@ -0,0 +1 @@
+label: Replication
diff --git a/docs/07-system-internals/05-security/01-kerberos.md
b/docs/07-system-internals/05-security/01-kerberos.md
new file mode 100644
index 00000000..8885c782
--- /dev/null
+++ b/docs/07-system-internals/05-security/01-kerberos.md
@@ -0,0 +1,10 @@
+---
+sidebar_label: Kerberos
+---
+
+# How Ozone Uses Kerberos
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+Document which Ozone components use Kerberos, what calls they make, and why.
+
diff --git a/docs/07-system-internals/05-security/02-symmetric-encryption.md
b/docs/07-system-internals/05-security/02-symmetric-encryption.md
new file mode 100644
index 00000000..c5b45d84
--- /dev/null
+++ b/docs/07-system-internals/05-security/02-symmetric-encryption.md
@@ -0,0 +1,10 @@
+---
+sidebar_label: Symmetric Encryption
+---
+
+# Symmetric Encryption Within Ozone
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+Document Ozone's shared secret model and how it is used within Ozone
components. Also document performance advantages over asymmetric encryption.
+
diff --git a/docs/07-system-internals/05-security/03-tokens.md
b/docs/07-system-internals/05-security/03-tokens.md
new file mode 100644
index 00000000..89164f6d
--- /dev/null
+++ b/docs/07-system-internals/05-security/03-tokens.md
@@ -0,0 +1,10 @@
+---
+sidebar_label: Tokens
+---
+
+# Token Based Authentication Within Ozone
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+Document how Ozone generates and uses container and block tokens, and why they
are used.
+
diff --git a/docs/07-system-internals/05-security/04-certificates.md
b/docs/07-system-internals/05-security/04-certificates.md
new file mode 100644
index 00000000..9b59cc5d
--- /dev/null
+++ b/docs/07-system-internals/05-security/04-certificates.md
@@ -0,0 +1,10 @@
+---
+sidebar_label: Certificates
+---
+
+# Certificates Within Ozone
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+Document how Ozone generates and uses certificates. This includes primordial
SCM and SCMs as root and sub-CAs.
+
diff --git a/docs/07-system-internals/05-security/05-tls.md
b/docs/07-system-internals/05-security/05-tls.md
new file mode 100644
index 00000000..2bcc0934
--- /dev/null
+++ b/docs/07-system-internals/05-security/05-tls.md
@@ -0,0 +1,10 @@
+---
+sidebar_label: TLS
+---
+
+# TLS Within Ozone
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+Document how Ozone sets up TLS/mTLS connections between components.
+
diff --git a/docs/07-system-internals/05-security/06-sasl.md
b/docs/07-system-internals/05-security/06-sasl.md
new file mode 100644
index 00000000..9cb3c184
--- /dev/null
+++ b/docs/07-system-internals/05-security/06-sasl.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: SASL
+---
+
+# SASL Within Ozone
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git a/docs/07-system-internals/05-security/07-s3-credentials.md
b/docs/07-system-internals/05-security/07-s3-credentials.md
new file mode 100644
index 00000000..4d236e27
--- /dev/null
+++ b/docs/07-system-internals/05-security/07-s3-credentials.md
@@ -0,0 +1,10 @@
+---
+sidebar_label: S3 Credentials
+---
+
+# S3 Credentials Within Ozone
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+Document how Ozone maps S3 credentials to Kerberos principals for
authentication.
+
diff --git a/docs/07-system-internals/05-security/_category_.yml
b/docs/07-system-internals/05-security/_category_.yml
new file mode 100644
index 00000000..76a1b343
--- /dev/null
+++ b/docs/07-system-internals/05-security/_category_.yml
@@ -0,0 +1 @@
+label: Security
diff --git a/docs/07-system-internals/06-network-protocols/01-overview.md
b/docs/07-system-internals/06-network-protocols/01-overview.md
new file mode 100644
index 00000000..440230ec
--- /dev/null
+++ b/docs/07-system-internals/06-network-protocols/01-overview.md
@@ -0,0 +1,10 @@
+---
+sidebar_label: Overview
+---
+
+# Overview of Network Protocols Used Within Ozone
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+Provide a list of the different network protocols used within Ozone (GRPC,
Hadoop RPC, Netty, HTTP) their purpose, and how they are secured (TLS, SASL). A
system diagram with each connection's protocol labelled would be good to have
here too.
+
diff --git a/docs/07-system-internals/06-network-protocols/02-client.md
b/docs/07-system-internals/06-network-protocols/02-client.md
new file mode 100644
index 00000000..ab1cd067
--- /dev/null
+++ b/docs/07-system-internals/06-network-protocols/02-client.md
@@ -0,0 +1,24 @@
+---
+sidebar_label: Client
+---
+
+# Network Protocols Used By Ozone Clients
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+For each section, indicate the network protocol that is used, why it is used,
and how it is secured. Some intro/explanation at the top here would be good too.
+
+| Client | Server | Protocol | Authentication | Authorization | Encryption |
Notes |
+|-|-|-|-|-|-|-|
+S3 Client | S3 Gateway | HTTPS | S3 Secrets | ACLs | TLS | S3 gateway REST API
is compatible with regular S3 HTTP clients.
+HDFS Client | Ozone Manager | Hadoop RPC | Kerberos | ACLs | SASL | HDFS
client uses Ozone client jar internally to communicate with Ozone.
+Ozone Client | Ozone Manager | Hadoop RPC | Kerberos | ACLs | SASL | Hadoop
RPC is used to transfer Kerberos information.
+Ozone Client | Storage Container Manager | | | | | |
+Ozone Client | Datanode | gRPC | | | | |
+Ozone Client | Kerberos KDC | | | | | |
+Ozone Client | Ranger KMS | | | | | |
+REST Client | HttpFS Server | | | | | |
+REST Client | Recon REST API | HTTPS | Kerberos + SPNEGO | [Configured Ozone
Administrators](../../administrator-guide/configuration/security/administrators)
| TLS | |
+Web Browser | Recon UI | HTTPS | Kerberos + SPNEGO/Apache Knox | [Configured
Ozone
Administrators](../../administrator-guide/configuration/security/administrators)
| TLS | |
+Web Browser | Ozone WebUIs | HTTPS | Kerberos + SPNEGO/Apache Knox | | TLS | |
+
diff --git a/docs/07-system-internals/06-network-protocols/03-server.md
b/docs/07-system-internals/06-network-protocols/03-server.md
new file mode 100644
index 00000000..b6242045
--- /dev/null
+++ b/docs/07-system-internals/06-network-protocols/03-server.md
@@ -0,0 +1,23 @@
+---
+sidebar_label: Server
+---
+
+# Network Protocols Used Among Ozone Servers
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
+For each section, indicate the network protocol that is used, why it is used,
and how it is secured. Add some intro/explanation at the top here.
+
+| Client | Server | Protocol | Authentication | Encryption | Notes |
+|-|-|-|-|-|-|
+Ozone Manager | Storage Container Manager | gRPC | Certificate | TLS | Used to
allocate blocks, delete blocks, and get block locations.
+Ozone Manager | Ranger | | | |
+Ozone Manager | S3 Secret Store | | | |
+Datanode | Datanode | | | |
+Datanode | Storage Container Manager | | | |
+Datanode | Recon | | | |
+Recon | Ozone Manager | | | |
+Recon | Storage Container Manager | | | |
+All Ozone Components | Kerberos KDC | | | |
+Prometheus | All Ozone Components | | | |
+
diff --git a/docs/07-system-internals/06-network-protocols/_category_.yml
b/docs/07-system-internals/06-network-protocols/_category_.yml
new file mode 100644
index 00000000..bc20dd51
--- /dev/null
+++ b/docs/07-system-internals/06-network-protocols/_category_.yml
@@ -0,0 +1 @@
+label: Network Protocols
diff --git a/docs/07-system-internals/07-features/01-filesystem-optimization.md
b/docs/07-system-internals/07-features/01-filesystem-optimization.md
new file mode 100644
index 00000000..a9f666b2
--- /dev/null
+++ b/docs/07-system-internals/07-features/01-filesystem-optimization.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Filesystem Optimization (FSO)
+---
+
+# File System Optimization (FSO) System Internals
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git a/docs/07-system-internals/07-features/02-upgrade-downgrade.md
b/docs/07-system-internals/07-features/02-upgrade-downgrade.md
new file mode 100644
index 00000000..f5e40e9f
--- /dev/null
+++ b/docs/07-system-internals/07-features/02-upgrade-downgrade.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Upgrade and Downgrade
+---
+
+# Upgrade and Downgrade System Internals
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
diff --git a/docs/07-system-internals/07-features/03-bucket-snapshots.md
b/docs/07-system-internals/07-features/03-bucket-snapshots.md
new file mode 100644
index 00000000..d6326fde
--- /dev/null
+++ b/docs/07-system-internals/07-features/03-bucket-snapshots.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Bucket Snapshot
+---
+
+# Bucket Snapshot System Internals
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git a/docs/07-system-internals/07-features/04-erasure-coding.md
b/docs/07-system-internals/07-features/04-erasure-coding.md
new file mode 100644
index 00000000..cf3c54b2
--- /dev/null
+++ b/docs/07-system-internals/07-features/04-erasure-coding.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: Erasure Coding
+---
+
+# Erasure Coding System Internals
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git a/docs/07-system-internals/07-features/05-ratis-streaming.md
b/docs/07-system-internals/07-features/05-ratis-streaming.md
new file mode 100644
index 00000000..6276509e
--- /dev/null
+++ b/docs/07-system-internals/07-features/05-ratis-streaming.md
@@ -0,0 +1,10 @@
+---
+# Page is accessible by direct link only in production site builds. It can be
included in the sidebar when the feature is complete.
+unlisted: true
+sidebar_label: Ratis Streaming
+---
+
+# Ratis Streaming System Internals
+
+**TODO:** File a subtask under
[HDDS-9862](https://issues.apache.org/jira/browse/HDDS-9862) and complete this
page or section.
+
diff --git a/docs/07-system-internals/07-features/_category_.yml
b/docs/07-system-internals/07-features/_category_.yml
new file mode 100644
index 00000000..8b114ea5
--- /dev/null
+++ b/docs/07-system-internals/07-features/_category_.yml
@@ -0,0 +1 @@
+label: Features
diff --git a/docs/07-system-internals/_category_.yml
b/docs/07-system-internals/_category_.yml
new file mode 100644
index 00000000..d4928d28
--- /dev/null
+++ b/docs/07-system-internals/_category_.yml
@@ -0,0 +1 @@
+label: System Internals
diff --git a/docs/08-developer-guide/01-build/01-prerequities.md
b/docs/08-developer-guide/01-build/01-prerequities.md
new file mode 100644
index 00000000..e812515c
--- /dev/null
+++ b/docs/08-developer-guide/01-build/01-prerequities.md
@@ -0,0 +1,12 @@
+---
+sidebar_label: Prerequisites
+---
+
+# Prerequisites to Build Ozone From Source
+
+**TODO:** File a subtask under
[HDDS-9861](https://issues.apache.org/jira/browse/HDDS-9861) and complete this
page or section.
+
+- Minimum maven and java versions required to build Ozone.
+- Install other necessary libraries like Proto 2.5 or RocksDB if necessary.
+- Setup on an aarch64 machine like Apple Silicon.
+- Choosing which version to build (master vs. the corresponding tag names for
each release).
diff --git a/docs/08-developer-guide/01-build/02-maven.md
b/docs/08-developer-guide/01-build/02-maven.md
new file mode 100644
index 00000000..ebe2f775
--- /dev/null
+++ b/docs/08-developer-guide/01-build/02-maven.md
@@ -0,0 +1,10 @@
+---
+sidebar_label: Maven
+---
+
+# Building Ozone With Maven
+
+**TODO:** File a subtask under
[HDDS-9861](https://issues.apache.org/jira/browse/HDDS-9861) and complete this
page or section.
+
+- Cover basic maven commands to build and run tests.
+- Document all the Ozone specific maven flags we use to speed up or skip parts
of the build, and when they are useful.
diff --git a/docs/08-developer-guide/01-build/03-intellij.md
b/docs/08-developer-guide/01-build/03-intellij.md
new file mode 100644
index 00000000..2571248d
--- /dev/null
+++ b/docs/08-developer-guide/01-build/03-intellij.md
@@ -0,0 +1,9 @@
+---
+sidebar_label: Intellij
+---
+
+# Ozone Development With Intellij
+
+**TODO:** File a subtask under
[HDDS-9861](https://issues.apache.org/jira/browse/HDDS-9861) and complete this
page or section.
+
+Guide for setting up Intellij for Ozone development and workarounds for common
problems.
diff --git a/docs/08-developer-guide/01-build/04-docker-images.md
b/docs/08-developer-guide/01-build/04-docker-images.md
new file mode 100644
index 00000000..efb8fceb
--- /dev/null
+++ b/docs/08-developer-guide/01-build/04-docker-images.md
@@ -0,0 +1,11 @@
+---
+sidebar_label: Docker Images
+---
+
+# Building Ozone Docker Images
+
+**TODO:** File a subtask under
[HDDS-9861](https://issues.apache.org/jira/browse/HDDS-9861) and complete this
page or section.
+
+- Point to the ozone-docker repo and define its purpose as a testing/demo
image with Ozone binaries included.
+- Point to the ozone-docker-runner repo and define its purpose as a test image
where Ozone binaries can be mounted.
+- Instructions for building the images from source, customizing architecture
(arm).
diff --git a/docs/08-developer-guide/01-build/_category_.yml
b/docs/08-developer-guide/01-build/_category_.yml
new file mode 100644
index 00000000..43397727
--- /dev/null
+++ b/docs/08-developer-guide/01-build/_category_.yml
@@ -0,0 +1 @@
+label: Build
diff --git a/docs/08-developer-guide/02-run/01-intellij.md
b/docs/08-developer-guide/02-run/01-intellij.md
new file mode 100644
index 00000000..3f0732b9
--- /dev/null
+++ b/docs/08-developer-guide/02-run/01-intellij.md
@@ -0,0 +1,7 @@
+---
+sidebar_label: Intellij
+---
+
+# Running Ozone From Intellij
+
+**TODO:** File a subtask under
[HDDS-9861](https://issues.apache.org/jira/browse/HDDS-9861) and complete this
page or section.
diff --git a/docs/08-developer-guide/02-run/02-docker-compose.md
b/docs/08-developer-guide/02-run/02-docker-compose.md
new file mode 100644
index 00000000..f8cbbbc4
--- /dev/null
+++ b/docs/08-developer-guide/02-run/02-docker-compose.md
@@ -0,0 +1,12 @@
+---
+sidebar_label: Docker Compose
+---
+
+# Running Ozone From Docker Compose
+
+**TODO:** File a subtask under
[HDDS-9861](https://issues.apache.org/jira/browse/HDDS-9861) and complete this
page or section.
+
+- Reference common clusters from acceptance tests that can be used.
+- Define the Ozone runner image at ozone-docker-runner and its purpose to wrap
Ozone binaries.
+- How to define which image gets used in the cluster (runner or other
pre-built image).
+- Changing configurations in Docker compose (docker-config file,
transformation.py, etc).
diff --git a/docs/08-developer-guide/02-run/_category_.yml
b/docs/08-developer-guide/02-run/_category_.yml
new file mode 100644
index 00000000..13acac7a
--- /dev/null
+++ b/docs/08-developer-guide/02-run/_category_.yml
@@ -0,0 +1 @@
+label: Run
diff --git a/docs/08-developer-guide/03-test/01-unit-tests.md
b/docs/08-developer-guide/03-test/01-unit-tests.md
new file mode 100644
index 00000000..6cfe1682
--- /dev/null
+++ b/docs/08-developer-guide/03-test/01-unit-tests.md
@@ -0,0 +1,8 @@
+# Unit Tests
+
+**TODO:** File a subtask under
[HDDS-9861](https://issues.apache.org/jira/browse/HDDS-9861) and complete this
page or section.
+
+- Scope of Unit tests
+- Junit 4 vs 5.
+- Directory layout of test resources
+- Configuring log level.
diff --git a/docs/08-developer-guide/03-test/02-integration-tests.md
b/docs/08-developer-guide/03-test/02-integration-tests.md
new file mode 100644
index 00000000..c9850955
--- /dev/null
+++ b/docs/08-developer-guide/03-test/02-integration-tests.md
@@ -0,0 +1,8 @@
+# Integration Tests
+
+**TODO:** File a subtask under
[HDDS-9861](https://issues.apache.org/jira/browse/HDDS-9861) and complete this
page or section.
+
+- Scope. When to use integration tests vs unit or acceptance.
+- What is MinOzoneCluster?
+- Package structure. (integration-test package and dependency reasons for
having its own package)
+
diff --git a/docs/08-developer-guide/03-test/03-acceptance-tests.md
b/docs/08-developer-guide/03-test/03-acceptance-tests.md
new file mode 100644
index 00000000..46afe890
--- /dev/null
+++ b/docs/08-developer-guide/03-test/03-acceptance-tests.md
@@ -0,0 +1,7 @@
+# Acceptance Tests
+
+**TODO:** File a subtask under
[HDDS-9861](https://issues.apache.org/jira/browse/HDDS-9861) and complete this
page or section.
+
+- Scope (what should be acceptance tested)
+- Directory layout of acceptance tests
+- Running tests locally.
diff --git a/docs/08-developer-guide/03-test/04-continuous-integration.md
b/docs/08-developer-guide/03-test/04-continuous-integration.md
new file mode 100644
index 00000000..2b154c69
--- /dev/null
+++ b/docs/08-developer-guide/03-test/04-continuous-integration.md
@@ -0,0 +1,14 @@
+---
+sidebar_label: Continuous Integration
+---
+
+# Continuous Integration With GitHub Actions
+
+**TODO:** File a subtask under
[HDDS-9861](https://issues.apache.org/jira/browse/HDDS-9861) and complete this
page or section.
+
+Aggregate content from our various GitHub actions guides, including
+- [ci.md](https://github.com/apache/ozone/blob/master/.github/ci.md)
+-
[CONTRIBUTING.md](https://github.com/apache/ozone/blob/master/CONTRIBUTING.md#check-your-contribution)
+-
https://cwiki.apache.org/confluence/display/OZONE/Ozone+CI+with+Github+Actions
+-
https://cwiki.apache.org/confluence/display/OZONE/Github+Actions+tips+and+tricks.
+
diff --git a/docs/08-developer-guide/03-test/05-static-analysis.md
b/docs/08-developer-guide/03-test/05-static-analysis.md
new file mode 100644
index 00000000..5870a6b1
--- /dev/null
+++ b/docs/08-developer-guide/03-test/05-static-analysis.md
@@ -0,0 +1,9 @@
+---
+sidebar_label: Static Analysis
+---
+
+# Static Analysis With SonarQube
+
+**TODO:** File a subtask under
[HDDS-9861](https://issues.apache.org/jira/browse/HDDS-9861) and complete this
page or section.
+
+Document how Ozone uses SonarQube, how to access it, view results, and fix
issues.
diff --git a/docs/08-developer-guide/03-test/_category_.yml
b/docs/08-developer-guide/03-test/_category_.yml
new file mode 100644
index 00000000..a5bdf6dd
--- /dev/null
+++ b/docs/08-developer-guide/03-test/_category_.yml
@@ -0,0 +1 @@
+label: Test
diff --git a/docs/08-developer-guide/04-project/01-branches-and-tags.md
b/docs/08-developer-guide/04-project/01-branches-and-tags.md
new file mode 100644
index 00000000..06db9aec
--- /dev/null
+++ b/docs/08-developer-guide/04-project/01-branches-and-tags.md
@@ -0,0 +1,14 @@
+# Git Branches and Tags
+
+**TODO:** File a subtask under
[HDDS-9861](https://issues.apache.org/jira/browse/HDDS-9861) and complete this
page or section.
+
+- Most development happens on master
+- Try to keep master releasable
+- Usage of branches and tags to mark releases
+
+## Feature Branches
+
+- When to use feature branches
+- Feature branch merge process, including vote and checklist from Confluence.
+ - Checklist can be attached to Github PR and mailing list, does not need
to be updated on the website.
+
diff --git a/docs/08-developer-guide/04-project/03-release-guide.md
b/docs/08-developer-guide/04-project/03-release-guide.md
new file mode 100644
index 00000000..f62c5834
--- /dev/null
+++ b/docs/08-developer-guide/04-project/03-release-guide.md
@@ -0,0 +1,9 @@
+---
+sidebar_label: Release Manager Guide
+---
+
+# Apache Release Manager Guide
+
+**TODO:** File a subtask under
[HDDS-9861](https://issues.apache.org/jira/browse/HDDS-9861) and complete this
page or section.
+
+Port from confluence
diff --git a/docs/08-developer-guide/04-project/_category_.yml
b/docs/08-developer-guide/04-project/_category_.yml
new file mode 100644
index 00000000..2f6712d4
--- /dev/null
+++ b/docs/08-developer-guide/04-project/_category_.yml
@@ -0,0 +1 @@
+label: Project
diff --git a/docs/08-developer-guide/_category_.yml
b/docs/08-developer-guide/_category_.yml
new file mode 100644
index 00000000..3fc43263
--- /dev/null
+++ b/docs/08-developer-guide/_category_.yml
@@ -0,0 +1 @@
+label: Developer Guide
diff --git a/progress.sh b/progress.sh
new file mode 100755
index 00000000..cdebeb9a
--- /dev/null
+++ b/progress.sh
@@ -0,0 +1,31 @@
+#!/usr/bin/env sh
+
+# Run this script to see how many pages are filled in and how many are left.
This is an approximation based on the TODO
+# messages in existing stubbed out pages. Pass -v or --verbose to get a
specific list of pages.
+# This script can be deleted once the new website is complete.
+
+verbose='false'
+if [ "$1" = '-v' -o "$1" = '--verbose' ]; then
+ verbose='true'
+fi
+
+repo_dir="$(git rev-parse --show-toplevel)"
+page_count="$(find "$repo_dir/docs" "$repo_dir/src" -type f -name '*.md' | wc
-l)"
+incomplete_pages="$(grep -rl 'TODO' --include '*.md' "$repo_dir/docs"
"$repo_dir/src")"
+complete_pages="$(grep -rL 'TODO' --include '*.md' "$repo_dir/docs"
"$repo_dir/src")"
+
+echo "Total pages: $page_count"
+
+echo "------------"
+echo "Complete pages: $(echo "$complete_pages" | grep -vc '^$')"
+if [ "$verbose" = 'true' ]; then
+ echo "------------"
+ echo "$complete_pages"
+fi
+
+echo "------------"
+echo "Incomplete pages: $(echo "$incomplete_pages" | grep -vc '^$')"
+if [ "$verbose" = 'true' ]; then
+ echo "------------"
+ echo "$incomplete_pages"
+fi
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
