added top-level intro
Change-Id: I32782c5224a8cf35d700b01954bf7ca7078e9b92
diff --git a/dict.txt b/dict.txt
index 32f9673..8a9f71e 100644
--- a/dict.txt
+++ b/dict.txt
@@ -56,6 +56,7 @@
Radisys
Raspbian
RiaB
+SDN
Sercomm
Speedtest
Sunay
diff --git a/edge_deployment/overview.rst b/edge_deployment/overview.rst
index 560168b..e154fc1 100644
--- a/edge_deployment/overview.rst
+++ b/edge_deployment/overview.rst
@@ -5,14 +5,24 @@
Overview
========
-There are multiple ways to deploy Aether. This guide documents how ONF
-deployed and operated a multi-site configuration of Aether as part of
-the Pronto project. If you are interested in a minimal deployment of
-Aether suitable for development (e.g., in a VM on your laptop), see
-the guide for :doc:`Aether-in-a-Box </developer/aiab>`. If you are
-interested in deploying Aether on your own edge cluster, see the guide
-for :doc:`Aether OnRamp </onramp/overview>`.
+There are multiple ways to deploy Aether. If you are interested in a
+minimal deployment of Aether suitable for running on your laptop, see
+the guide for :doc:`Aether-in-a-Box </developer/aiab>`. If you are
+interested in deploying Aether on your own edge cluster(s), see the
+guide for :doc:`Aether OnRamp </onramp/overview>`.
+This guide documents how ONF deployed and operated a multi-site
+configuration of Aether as part of the Pronto project.\ [#]_ That
+deployment is being deprecated in favor of users bringing up their own
+Aether sites using :doc:`OnRamp </onramp/overview>`, but we include it here
+because it highlights many of the challenges facing a production
+deployment of Aether as a managed cloud service. Those challenges
+motivate many of the operational mechanisms still available in Aether,
+but now packaged for others to apply to their deployments.
+
+.. [#] The Pronto deployment also included edge clusters built on top
+ of an SDN-controlled and fully programmable switching fabric,
+ which is no longer supported in Aether.
Aether Central
--------------
diff --git a/index.rst b/index.rst
index b318a41..cd53cd6 100644
--- a/index.rst
+++ b/index.rst
@@ -1,57 +1,12 @@
-Aether Documentation
-====================
+.. include:: intro.rst
-Aether is an ONF's 5G/LTE Connected Edge Platform-as-a-Service. More
-information about Aether can be found at the `ONF website
-<https://opennetworking.org/aether/>`_.
+.. toctree::
+ :maxdepth: 3
+ :caption: Aether Documentation
+ :hidden:
+ :glob:
-
-Getting Started with Aether
----------------------------
-
-Here are some useful places to start with Aether:
-
-* Deploy and operate Aether on your own cluster with :doc:`Aether OnRamp </onramp/overview>`.
-
-* Setup an Aether software development environment with :doc:`Aether-in-a-Box </developer/aiab>`.
-
-* Learn about how to :doc:`operate Aether using the ROC </operations/gui>`.
-
-* Learn the requirements for a :doc:`Production Deployment of Aether
- </edge_deployment/overview>`.
-
-* Read the most recent :doc:`Release Notes </release/2.1>`.
-
-Aether Architecture and Components
-----------------------------------
-
-Aether uses components from several ONF projects. More information can be found
-at these sites:
-
-* SD-Core
-
- * `SD-Core Website <https://opennetworking.org/sd-core/>`_
- * :doc:`SD-Core Documentation <sdcore:index>`
-
-* SD-Fabric
-
- * `SD-Fabric Website <https://opennetworking.org/sd-fabric/>`_
- * :doc:`SD-Fabric Documentation <sdfabric:index>`
-
-* SD-RAN
-
- * `SD-RAN Website <https://opennetworking.org/open-ran/>`_
- * :doc:`SD-RAN Documentation <sdran:index>`
-
-More information about 5G and Aether's architecture can be found in
-the :doc:`Private 5G: A Systems Approach <sysapproach5g:index>` book.
-
-Community
----------
-
-Information about participating in the Aether community and development process
-can be found on the `ONF Wiki
-<https://wiki.opennetworking.org/display/COM/Aether>`_.
+ intro
.. toctree::
:maxdepth: 3
@@ -97,7 +52,7 @@
.. toctree::
:maxdepth: 3
- :caption: Production Deployment
+ :caption: Edge Deployment
:hidden:
:glob:
diff --git a/intro.rst b/intro.rst
new file mode 100644
index 0000000..f7a93ec
--- /dev/null
+++ b/intro.rst
@@ -0,0 +1,69 @@
+Introduction
+==============
+
+Aether is an open source 5G edge cloud connectivity service that
+supports enterprise deployments of Private 5G. Information about the
+Aether project can be found on the ONF website, and an introduction to
+the Aether architecture can be found in a companion book:
+
+.. _reading_private5g:
+.. admonition:: Further Reading
+
+ `Aether: An ONF Project <https://opennetworking.org/aether/>`_.
+
+ L. Peterson, O. Sunay, and B. Davie. `Private 5G: A Systems
+ Approach <https://5g.systemsapproach.org>`__. 2023
+
+
+Getting Started with Aether
+---------------------------
+
+There are two primary ways to get started with Aether:
+
+* Deploy and operate Aether on your own cluster with :doc:`Aether OnRamp </onramp/overview>`.
+
+* Setup an Aether software development environment with :doc:`Aether-in-a-Box </developer/aiab>`.
+
+Other Aether guides included on this site include:
+
+* Learn how to :doc:`operate Aether using the ROC </operations/gui>`.
+
+* Learn about the original :doc:`edge deployment of Aether
+ </edge_deployment/overview>`.
+
+* Learn how Aether is :doc:`tested </testing/about_system_tests>`.
+
+* Read the most recent :doc:`Release Notes </release/2.1>`.
+
+Aether Components
+------------------------
+
+Aether uses components from several ONF projects. Information about
+these projects can be found at the following sites:
+
+* SD-Core
+
+ * `SD-Core Website <https://opennetworking.org/sd-core/>`_
+ * :doc:`SD-Core Documentation <sdcore:index>`
+
+* SD-Fabric
+
+ * `SD-Fabric Website <https://opennetworking.org/sd-fabric/>`_
+ * :doc:`SD-Fabric Documentation <sdfabric:index>`
+
+* SD-RAN
+
+ * `SD-RAN Website <https://opennetworking.org/open-ran/>`_
+ * :doc:`SD-RAN Documentation <sdran:index>`
+
+More information about 5G and Aether's architecture can be found in
+the :doc:`Private 5G: A Systems Approach <sysapproach5g:index>` book.
+
+Community
+---------
+
+Information about participating in the Aether community and
+development process can be found on the `ONF Wiki
+<https://wiki.opennetworking.org/display/COM/Aether>`_. Join the
+discussion about Aether on Slack in the `ONF Community Workspace
+<https://onf-community.slack.com/>`__.