Improve docs

[kevindantas]

Summary

• Add support to Markdown as documentation
• Add component API to the website along side the demos
• Fixed a bug when preview the date on the Calendar component

Screenhots

[kevindantas]

I'm not sure what's the best strategy to create documentation for a lib, I saw that MaterialUI and Ant Design uses markdown to create their website documentation.
Do you guys have any suggestion about that?

[mikelfcosta]

I'm not sure what's the best strategy to create documentation for a lib, I saw that MaterialUI and Ant Design uses markdown to create their website documentation.
Do you guys have any suggestion about that?

I've used markdown before to create documentations. I think it's one of the best ways to do it, or using the gitbook.io service. I've actually recreated something like gitbook.io before.

[kevindantas]

I was thinking in using Storybook, but I'm not sure how it scales with an entire UI library, I always see being used for more specific cases, like the react-dates from Airbnb.

[mikelfcosta]

We could use Storybook for the whole UI Library.

[pedrodurek]

It's got awesome!

[pedrodurek]

gitbook is paid, for now we could use just regular markdown