Merge branch 'master' into feature/api-docs

content/concepts/testnets.md

@@ -0,0 +1,22 @@
+---
+title: Testnets
+description: An overview of public testnets that you can test Ocean Protocol applications against.
+---
+
+You can test an Ocean Protocol application (such as a marketplace) against some testnets that are maintained by the Ocean Protocol Foundation and others.
+
+## Kovan Testnet
+
+The [Kovan Testnet](https://github.com/kovan-testnet/proposal) (or just "Kovan") is a public Ethereum testnet operated by members of the Ethereum community. The Ocean Protocol [keeper contracts](https://github.com/oceanprotocol/keeper-contracts) (smart contracts) are deployed there.
+
+Moreover, there is a [Secret Store](/concepts/components/#secret-store) operated by the Ocean Protocol Foundation which is connected to the Kovan Testnet: the Ocean Secret Store for Kovan.
+
+There's a [tutorial about how to get set up to use a testnet](/tutorials/use-a-testnet/).
+
+## Ocean Testnet
+
+The Ocean Testnet is similar to the Kovan Testnet, except all the nodes are operated by the Ocean Protocol Foundation. The Ocean Protocol [keeper contracts](https://github.com/oceanprotocol/keeper-contracts) (smart contracts) are deployed there.
+
+Moreover, there is a [Secret Store](/concepts/components/#secret-store) operated by the Ocean Protocol Foundation which is connected to the Ocean Testnet: the Ocean Secret Store.
+
+For now, there's no easy way to get Ether for the Ocean Testnet, so we recommend using the Kovan Testnet (for now).

content/tutorials/use-a-testnet.md

@@ -0,0 +1,31 @@
+---
+title: How to Use a Testnet
+description: A tutorial showing how to get set up to use one of the public testnets.
+---
+
+At the time of writing, there were two public testnets you could use to test an Ocean Protocol application: the Kovan Testnet and the Ocean Testnet. For more information about those, see the page about [testnets](/concepts/testnets/). Also at the time of writing, there was no easy was to get Ether for the Ocean Testnet, so this tutorial is for the Kovan Testnet (for now).
+
+## Get a Compatible Wallet
+
+You will need a wallet that can hold Ether (for any Ethereum network) and Ocean Tokens (for any Ethereum network). For now, we recommend using [MetaMask](https://metamask.io/).
+
+- Follow the MetaMask instructions to install it on your machine.
+- In MetaMask, switch from the **Main Ethereum Network** to the **Kovan Test Network**.
+
+## Get Kovan Ether (KEth)
+
+You can get Kovan Ether (KEth) from a Kovan faucet: see [the official list of Kovan faucets](https://github.com/kovan-testnet/faucet). You have to give the faucet your Kovan address (wallet account address). You can get that from MetaMask. It's a string that looks like:
+
+```text
+0xa0A9d7f78bF293514e7cA2789A0Af689eEC99282
+```
+
+## Next Steps
+
+You may want to get some Ocean Tokens for the Kovan Testnet (e.g. so you can buy assets). Currently, the easiest way to get some Ocean Tokens is by running Pleuston (a demo Ocean marketplace web app) and then clicking in the top right corner of the Pleuston user interface. If you see "Make it rain" then click that.
+
+Running Pleuston, along with all the software it needs to work, and configuring everything to work together (and connect to Kovan) is beyond the scope of this tutorial. If you want to do _that_, then the current best option is to use the scripts and Docker Compose files in the [🐳 docker-images repository](https://github.com/oceanprotocol/docker-images).
+
+<repo name="docker-images"></repo>
+
+Note that Kovan Ocean Tokens can't be transferred to or used in other Ethereum networks (or at least it wasn't possible at the time of writing).

data/sidebars/concepts.yml

@@ -8,6 +8,8 @@
       link: /concepts/components/
     - title: Tools & Examples
       link: /concepts/tools/
+    - title: Testnets
+      link: /concepts/testnets/
 
 - group: Architecture
   items:

data/sidebars/tutorials.yml

@@ -1,7 +1,9 @@
-- group: Overview
+- group: Basics
   items:
     - title: Introduction
       link: /tutorials/introduction/
+    - title: How to Use a Testnet
+      link: /tutorials/use-a-testnet/
 
 - group: Publish
   items: