Overhauling the design document (openshift#1619)

* Overhauling the design document This commit also splits the details about resources into a new file: resources.md * Fixing links * Addressing @MHBauer's comments * Making a wording change h/t @nilebox
jboyd01 · Dec 19, 2017 · f59adc9 · f59adc9
1 parent cd7b633
commit f59adc9
Show file tree

Hide file tree

Showing 5 changed files with 278 additions and 286 deletions.
diff --git a/docs/README.md b/docs/README.md
@@ -5,12 +5,17 @@ the articles in here. We recommend you start by reading the
 [introduction](introduction.md), and then move on to the 
 [installation instructions](./install.md).
 
-Afterward, see the below list of topics:
+Afterward, see the topics below.
 
 ## Topics for users:
-- [Passing parameters to ServiceInstances and ServiceBindings](./parameters.md)
+
+- [Installation instructions](install.md)
+- [Walkthrough](walkthrough.md)
+- [The Service Catalog Resources In Depth](./resources.md)
+- [Passing parameters to ServiceInstances and ServiceBindings](parameters.md)
 
 ## Topics for developers:
+
 - [Code conventions](./code-standards.md)
 - [Developer guide](./devguide.md)
 - [Design](./design.md)