From 233e5ff88bf3d514cb0497098f944098d9d7f238 Mon Sep 17 00:00:00 2001
From: Ann Almgren <asalmgren@lbl.gov>
Date: Thu, 18 Oct 2018 16:05:56 -0700
Subject: [PATCH] Trying to organize

---
 docs/source/FluidEquations.rst | 11 +++++++++++
 docs/source/Fluids.rst         | 10 ++++++++++
 docs/source/Particles.rst      |  4 +++-
 docs/source/index.rst          |  7 ++-----
 4 files changed, 26 insertions(+), 6 deletions(-)
 create mode 100644 docs/source/Fluids.rst

diff --git a/docs/source/FluidEquations.rst b/docs/source/FluidEquations.rst
index d7d601d..c13ed9d 100644
--- a/docs/source/FluidEquations.rst
+++ b/docs/source/FluidEquations.rst
@@ -1,3 +1,6 @@
+Here we describe the fluid variables, the governing equations, and the time discretization
+of the fluid evolution.
+
 Fluid Variables
 ===============
 
@@ -33,3 +36,11 @@ Conservation of fluid volume:
 
 .. math:: \frac{\partial \varepsilon_g}{\partial t} + \nabla \cdot (\varepsilon_g  U_g)  = 0
 
+Time Discretization
+===============
+
+In the absence of reactions, we assume that the fluid density is unchanged.
+
+We compute the fluid volume fraction directly from the particle locations.
+
+Thus here we focus on the discretization of the momentum equation
diff --git a/docs/source/Fluids.rst b/docs/source/Fluids.rst
new file mode 100644
index 0000000..b8b2248
--- /dev/null
+++ b/docs/source/Fluids.rst
@@ -0,0 +1,10 @@
+.. _Chap:Fluids
+
+Solving the Fluid Equations
+===========================
+
+.. toctree::
+   :maxdepth: 1
+
+   FluidEquations
+
diff --git a/docs/source/Particles.rst b/docs/source/Particles.rst
index 50450bc..eb37c57 100644
--- a/docs/source/Particles.rst
+++ b/docs/source/Particles.rst
@@ -1,3 +1,5 @@
+.. _Chap:Particles
+
 Particles
 =========
 
@@ -22,7 +24,7 @@ particle-particle, particle-fluid, and particle-wall interactions.
    :caption: Contents:
 
    ParticleBasics
-   ParticleFuild
+   ParticleFluid
    ParticleWalls
 
 
diff --git a/docs/source/index.rst b/docs/source/index.rst
index 89f0a21..245c0ad 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -17,16 +17,13 @@ active development in the develop branch. Changes are merged into
 the master branch at the beginning of each month.
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
    :caption: Contents:
 
    Introduction
    GettingStarted
-   FluidEquations
+   Fluids
    Particles
-   ParticleBasics
-   ParticleFluid
-   ParticleWalls
 
 Notice
 ------
-- 
GitLab