Issue 668/documentation improvements

README.md

@@ -24,12 +24,15 @@ With ocean.js, you can:
 
 ocean.js is part of the [Ocean Protocol](https://oceanprotocol.com) toolset.
 
-This is in alpha state and you can expect running into problems. If you run into them, please open up a [new issue](/issues).
+This is in alpha state and you can expect running into problems. If you run into them, please open up a [new issue](https://github.com/oceanprotocol/ocean.js/issues/new?assignees=&labels=bug&template=bug_report.md&title=).
 
+- [📚 Prerequisites](#-prerequisites)
 - [🏗 Installation](#-installation)
 - [🏄 Quickstart](#-quickstart)
+  - [Beginners Guide](#beginners-guide)
   - [Simple Flow](#simple-flow)
   - [Marketplace Flow](#marketplace-flow)
+  - [📖 Learn More](#learn-more)
 - [🦑 Development](#-development)
 - [✨ Code Style](#-code-style)
 - [👩‍🔬 Testing](#-testing)
@@ -40,6 +43,11 @@ This is in alpha state and you can expect running into problems. If you run into
   - [Production](#production)
 - [🏛 License](#-license)
 
+## 📚 Prerequisites
+- node.js ([Install from here](https://nodejs.org/en/download/))
+- Docker ([Managed as a non-root user](https://docs.docker.com/engine/install/linux-postinstall/)) 
+- A Unix based operating system (Mac or Linux) 
+
 ## 🏗 Installation
 
 ```bash
@@ -67,6 +75,11 @@ async function init() {
   return ocean
 }
 ```
+### Beginners Guide
+
+This introduction is aimed at developers who are completely new to blockchain, no coding experience is required. 
+
+[Go to beginners guide](docs/beginners_guide.md)
 
 ### Simple Flow
 
@@ -80,13 +93,26 @@ This batteries-included flow includes metadata, multiple services for one datato
 
 [Go to marketplace flow](docs/quickstart_marketplace.md)
 
+### 📖 Learn more
+
+-   [Get test OCEAN](docs/get-test-OCEAN.md) - from rinkeby
+-   [Understand config parameters](docs/parameters.md) - envvars vs files
+-   [Learn about off-chain services](docs/services.md) - Ocean Provider for data services, Aquarius metadata store
+-   [Learn about wallets](docs/wallets.md) - on generating, storing, and accessing private keys
+-   [Get an overview of ocean.js](docs/overview.md) - key modules and functions
+
+If you have any difficulties with the quickstarts, or if you have further questions about how to use ocean.js please reach out to us on [Discord](https://discord.gg/TnXjkR5).
+
+If you notice any bugs or issues with Ocean.js please [open an issue on github](https://github.com/oceanprotocol/ocean.js/issues/new?assignees=&labels=bug&template=bug_report.md&title=). 
+
 ## 🦑 Development
 
 The project is authored with TypeScript and compiled with `tsc`.
 
 To start compiler in watch mode:
 
 ```bash
+npm install
 npm start
 ```