TLDR: We will be splitting the Hiro documentation from the Stacks ecosystem documentation over the next month. A new Hiro-focused documentation site will be created. The Stacks ecosystem documentation will be handed over to the community.
The Stacks ecosystem has done a lot together. As a community, we came together to keep up with the developer documentation for advancements of the Clarity language, the Stacks blockchain, the tooling, and more. We organized docs days, encouraged and added contributors, maintainers, and reviewers for the docs repository, and established an open communication channel in the Stacks discord.
The ecosystem is growing
The Stacks ecosystem is thriving like never before! Thanks to the Stacks Accelerator, the Grants program, independent builders and more, we have a many teams working on tools relevant for developers. Some of these builders already created their own documentation. With all of these folks joining our community, it’s our collective duty to ensure new developers joining the Stacks ecosystem can discover and learn about all the great projects from a wide range of ecosystem contributors. At the same time, we as Hiro, need to advance the documentation for the new and updated developer tools Hiro is actively developing.
The need for a split
And this brings us to why we think there needs to be an evolution. Currently, the general Stacks documentation exists alongside documentation that represents Hiro products. This presents several challenges:
Hiro’s focus on the documentation around its own developer tools could leave a gap in resources focused specifically on Stacks documentation, and that could lead to outdated or incomplete documentation on the Stacks side
There is no ecosystem-wide documentation effort, working group, or roadmap
Highly relevant, new documentation sites are appearing but not surfaced well enough to Stacks developers
The new Hiro docs site
We are planning to create our new Hiro Documentation site (coming soon at
docs.hiro.so) that will focus solely on Hiro development tools. It will be open-source, and open to community contribution, although subject to a tighter roadmap set by the Hiro docs team, and beholden to Hiro feature development. Hiro’s docs team will exercise editorial discretion over the Hiro docs, and will communicate regularly with the Stacks community on enhancements to Hiro products and documentation.
This work is estimated to be completed by the end of September.
Next steps for ecosystem documentation
With the above change, the community can take ownership of the existing Stacks ecosystem docs (minus Hiro docs) at
docs.stacks.co. Our initial thought is that it could cover topics such as an explanation of the Proof of Transfer consensus mechanism, mining, Clarity language, and more, but the exact content and scope will be up to you. This site would need to be maintained by the community, and not just by Hiro. Of course, Hiro expects it will participate from time to time as one of the ecosystem contributors, but we will not set the roadmap or agenda, nor will we exercise final editorial control.
Some things we’ve thought about as a starting point for the community’s conversation about this:
How can all ecosystem contributors best leverage the documentation for discoverability and education about their solutions in a fair way?
Who will help maintain the Stacks ecosystem documentation site from a technical, operational, and from content standpoint?
How and who will proactively engage with ecosystem contributors to align on a roadmap?
So Stackers - have at it! We’ll be participating in the thread here or wherever else you’d like to continue the conversation about the evolution of the docs!