A DTCG design tokens to HTML documentation transformer
This project is in its infancy. It aims to be a collaborative FOSS tool to convert design token JSON files to HTML documentation. The idea is to then use this tool to produce token doc for Storybook users, but also to harness collaboration from other tool makers (like Handoff or Backlight) and design system engineers who have built such documentation for their orgs.
Folks who are interested in participating and with a track record of FOSS contribution and relevant experience (Storybook, documentation projects like Vitepress, 11ty, Starlight, Design Systems engineers, DTCG contributors, etc.) are all welcome to join and define with us what such documentation should look like, and what options the tool should have. The idea is to run async discussions on features, architecture and input/output formats, and then to get to work.
https://github.com/sidnioulz expects to do most of the dev work themselves but want to give folks who care about this topic a chance to have their needs heard and addressed. This project is invite-only. Folks who were invited are welcome and encouraged to invite others too. Folks who work on closed-source commercial token documentation tools are not welcome on this project.
- Look up open issues and/or the associated GitHub project (with extra drafts, needs an invite)
- Discuss, debate, contradict, propose, showcase: share your expertise
- Propose your own topics in issues, discussions, etc.
- Once consensus is reached on an issue, help prioritise it using the RICE framework
- If you have time to contribute, and once this project is sufficiently well scaffolded, pick up an issue that's ready to dev and get going
https://www.contributor-covenant.org/version/2/1/code_of_conduct/
GNU Affero GPL v3 until decided otherwise by contributors.