From dcb70ee101dd18cc0d7be51b2ea481855c88fc2f Mon Sep 17 00:00:00 2001
From: David Wells <wellsd2@rpi.edu>
Date: Sat, 9 Jan 2016 13:28:03 -0500
Subject: [PATCH] Reformat the CDR README.

The code gallery code does not pick up markdown lists so I switched
those to HTML lists. I also included more design information and
explained the directory structure better.
---
 cdr/readme.md | 42 ++++++++++++++++++++++++++++++++----------
 1 file changed, 32 insertions(+), 10 deletions(-)

diff --git a/cdr/readme.md b/cdr/readme.md
index 848e05a..67e1747 100644
--- a/cdr/readme.md
+++ b/cdr/readme.md
@@ -1,20 +1,42 @@
 ## Overview
 I started this project with the intent of better understanding adaptive mesh
-refinement, parallel computing, and `CMake`. In particular, I started by writing
-a uniform mesh, single process solver and then ultimately expanded it into
-`solver/cdr.cc`. This example program might be useful to look at if you want to
-see:
-* A more complex `CMake` setup, which builds a shared object library and an
-  executable
-* A simple parallel time stepping problem
-* Use of `C++11` lambda functions
+refinement, parallel computing, and <code>CMake</code>. In particular, I started
+by writing a uniform mesh, single process solver and then ultimately expanded it
+into <code>solver/cdr.cc</code>. This example program might be useful to look at
+if you want to see:
+<ul>
+  <li>A more complex `CMake` setup, which builds a shared object library and an
+  executable</li>
+  <li>A simple parallel time stepping problem</li>
+  <li>Use of `C++11` lambda functions</li>
+</ul>
 
 The other solvers are available [here](http://www.github.com/drwells/dealii-cdr).
 
+Unlike the other tutorial programs, I have split this solver into a number of
+files in nested directories. In particular, I used the following strategy
+(more-or-less copied [ASPECT](http://aspect.dealii.org)):
+<ul>
+  <li>The <code>common</code> directory, which hosts files common to the four
+  solvers I wrote along the way. Most of the source files in
+  <code>common/source/</code> are just <i>template specializations</i>; they
+  compile the template code for specific dimensions and linear algebra (matrix
+  or vector) types. The <code>common/include/deal.II-cdr/</code> directory
+  contains both templates and plain header files.</li>
+  <li>The <code>solver/</code> directory contains the actual solver class and
+  strongly resembles a tutorial program. The file <code>solver/cdr.cc</code>
+  just sets up data structures and then calls routines in
+  <code>libdeal.II-cdr-common</code> to populate them and produce output.</li>
+</ul>
+
+
+
 
 ## Requirements
-* A `C++-11` compliant compiler
-* The development version of `deal.II`
+<ul>
+  <li>A <code>C++-11</code> compliant compiler</li>
+  <li>Version 8.4 of <code>deal.II</code></li>
+</ul>
 
 
 ## Compiling and running
-- 
2.39.5