Integrate docs and API with official website. about crystal-website HOT 4 OPEN

The color and style integration for the API is a very welcome change ( the current design sticks out very much ).

But i do always question to use of putting all the API on a single page. For bitarray its less of a issue as its only a two pager but take for instance IO.

http://br.crystal-lang.org/api/IO.html

That is a 20 pager ( more on a 1080p screen ).

Is it not more logical to first have a "overview" page and then have every function and instants ( with a short description ), what then links to its own sub-page ( with the Description, Example(s), View Source)?

As the language and api grows, it will also introduce more clutter in the documentation.

from crystal-website.

@Wulfklaue didn't noticed brazilian version was outdated. I can fix that if I find where is it located 😄

from crystal-website.

@hugoabonizio , do not have a clue where its located, i simply pulled the API from a google search to show as a example, did not even realize it was the Brazilian version ( what makes no sense as my geographic location is German ). Google being Google i assume? :)

from crystal-website.

@Wulfklaue The whole API docs under this domain are in english anyway 😆

from crystal-website.