Add links to docs/README (openshift#1589)

Author: pmorie

Diff for: docs/README.md

@@ -1,6 +1,16 @@
 ## service-catalog docs
 
+Start by checking out the [introduction](introduction.md).
+
+Topics for users:
+- [Installation instructions](install.md)
+- [Walkthrough](walkthrough.md)
+- [Passing parameters to ServiceInstances and ServiceBindings](parameters.md)
+
+Topics for developers:
+- [Code conventions](code-standards.md)
 - [Developer guide](devguide.md)
 - [Design](design.md)
+- [Notes on authentication](auth.md)
 
 We are collecting use-cases and other fundamental documentation for our eventual [V1 GA release here](./v1).