Add an outline of software design doc (#126)

* Fix code inside list

* Added skeleton of the software design doc

docs/source/contents/getting-started/docker-installation/index.md

@@ -4,12 +4,11 @@
 
  1. Git clone seldon-core-v2
 
-  ```bash
-  git clone https://github.com/SeldonIO/seldon-core-v2
-  ```
- 3. Build [Seldon CLI](../cli.md)
- 4. Install [Docker Compose](https://docs.docker.com/compose/install/).
- 5. Install `make`.
+        git clone https://github.com/SeldonIO/seldon-core-v2
+
+ 2. Build [Seldon CLI](../cli.md)
+ 3. Install [Docker Compose](https://docs.docker.com/compose/install/).
+ 4. Install `make`.
 
 
 ## Deploy

docs/source/contents/software-design.md

@@ -0,0 +1,36 @@
+# Seldon Core v2 design
+
+Seldon Core underwent a complete re-design internally, compared to version 1. Here we go over the main concepts and design decisions taken in V2.
+
+## Inference graph
+
+This section talks about inference graph and its components.
+
+## Dataflow paradigm
+
+What is dataflow, how it is different from v1.
+
+## Data streams and Kafka
+
+Introducing data streams and Kafka, explain why we decided to go with it.
+
+## Dataflow graph in SCv2
+
+### General overview
+General description of our approach, maybe a nice diagram of a sample dataflow graph
+
+### Chainer
+
+Explain what is the chainer component and what it is responsible for
+
+### Gateways
+
+Talk about the components that streams of data to and from service calls
+
+### Error handling
+
+How do we handle errors
+
+## Why?
+
+Greater flexibility, decentralized approach, native support for async scenarios, data lineage possible throughout

docs/source/index.md

@@ -6,4 +6,5 @@
 :includehidden:
 
 contents/getting-started/index
+contents/software-design
 ```