[comis]

We've got some semi-automated documentation for our React component library. It's broken down into Assemblies, Components, and Elements with each variation having it's own SKU which makes going back and forth from design to documentation pretty simple.

When I first started it helped me a ton with getting up to speed (especially as a designer turned developer). One of the neat things about it is that it uses our flow types to pull out required/optional props and their types.

The main negative is that there's no simple way for designers to directly contribute to it at the moment.