docs refactoring

* more separation of platform/technologies
* better explanation on single page apps and APIs
* support for includes

    @@includes.whatever@@

If there is a `whatever.md` file under `docs/includes` it will render that. This is used for cases where we want to repeat something on every document.