Short examples in the docs

[teevik]

The idea is from http://reddit.com/r/typescript/comments/b2hz2r/marblejs_functional_reactive_http_framework_built/eit5agg

So what we could do is to have a section in the docs where each page would be a small example on a specific topic. Some examples could be

• Hello world
• Routing
• Combining routes
• Context
• Authentication

[JozefFlakus]

Hi @teevik!

Thank you for pointing out this thread. 💪 Yeah, I know that the docs are not perfect and that's why I really appreciate this feedback.

Do you have any examples of how can we improve it? Eg. do you think that each „chapter” should have at the end some small example that summarizes it or each chapter should be built upon the example, eg. like Angular does it with Tour of Heroes?

[teevik]

I was thinking more of just a list of small examples. Something similar to what typeorm does here: https://github.com/typeorm/typeorm/tree/master/sample . Typeorm has a few files for each example, but for marble.js it might work to have a single file for each example

Also doesn't necessarily need to be in the docs, could just be files github like at typeorm