Restructure reference guide.

docs/README.md

@@ -2,6 +2,10 @@
 
 Aquascape is a diagramming tool for [fs2](https://github.com/typelevel/fs2).
 
+The diagrams can be used to illustrate the behaviour of fs2 operators. By reading the diagrams, you will learn more about the operators and streams.
+
+This website contains an aquascape-based reference guide to fs2, based on aquascapes. Read it [here](reference/README.md).
+
 ## The basic idea
 
 A stream is built from **stages**. When evaluated:

docs/reference/README.md

@@ -0,0 +1,17 @@
+# Reference Guide
+
+This is an aquascape-based reference guide to fs2.
+
+Learn [how to read aquascapes](../README.md#how-to-read-the-diagrams), then learn about an operator:
+
+ - [take, takeWhile, takeThrough, takeRight](take.md)
+ - [drop, dropWhile, dropThrough, dropLast, dropLastIf](drop.md)
+ - [filter, filterNot, filterWithPrevious, changes, mapFilter](filter.md)
+ - [evalMap, evalTap, evalMapChunk, evalTapChunk](evalMap.md)
+ - [bracket, bracketCase, resource, onFinalize, onFinalizeCase](bracket.md)
+ - [merge, mergeHaltL, mergeHaltR](merge.md)
+ - [flatMap](flatMap.md)
+ - [append, `++`](append.md)
+ - [raiseError, handleError, handleErrorWith, attempt](errors.md)
+ - [chunks, unchunks, chunkLimit, chunkMin, chunkN](chunk.md)
+