Improvements to the docs

[DmitrySharabin]

It looks like our docs is not in its best shape for now. We should definitely improve it.

It would be nice if we have not only simple “foo-bar” demos but also some sort of real-life-like apps illustrating some of the most common cases. At least the way we see them now.

The API section of the docs seems to be the biggest issue.

[LeaVerou]

@DmitrySharabin could you make this issue more specific and assign appropriate labels or milestone(s)?

[DmitrySharabin]

The API section of the docs seems to be the biggest issue.

It's not an issue anymore. The API section is OK, but the main page. It should have a README. But we already have a separate issue for this.

It would be nice if we have not only simple “foo-bar” demos but also some sort of real-life-like apps illustrating some of the most common cases. At least the way we see them now.

This is also covered in a separate issue.

So, I would close this issue. We have more specific issues to track.