balena-io-modules / rendition

A library of React UI components
https://balena-io-modules.github.io/rendition
Apache License 2.0
213 stars 27 forks source link

Create a website for Rendition #700

Open sradevski opened 5 years ago

sradevski commented 5 years ago

The website should be used partly to explain Rendition on a higher level, and partly for marketing purposes. We can also provide an interactive playground so people can play around with the library before using it. The Auth0 Cosmos website is a good example of this.

Some examples of nice styled system-based libraries and their websites are:

corysimmons commented 4 years ago

How about just Gitbook with a pretty/big masthead image with Rendition's logo, screenshots, and links to Storybook components? It'd be easy, fast, clean, and most importantly: way more usable than most of the stuff other projects bespoke.

Gitbook is also free for OSS, whereas things like Zeroheight aren't.


Update: Something like this https://csimmonswork.gitbook.io/rendition/ but with a few images. I don't think we can embed CodeSandbox or Storybook into Gitbook, but I'm okay with that as long as I can automate this entire thing in the build process.

Something else I noticed we'd need that Gitbook offers is variants (so like docs for different versions).