$0.06098 1.64%
GNT · 23w

Golem - A short guide on Open Source documentation - introducing our new docs + sharing our findings for the community

Lowering the barriers of entry for users and developers is something the decentralized ecosystem recognizes as a big pain point. Comprehensive, complete and ordered documentation is one of the elements to address towards the aforementioned goal.

Our UX team has been working in close collaboration with our developers on researching the best documentation standards in technology and finding a standardized solution for our own repository and knowledge bases. Golem has existed for a bit more than three years nowadays. Our repository has amassed a whopping +180.000 lines of code. We are working on APIs, have a user base, and are integrating new use-cases, so for us, standardizing and improving our documentation was a  high priority.

Thanks to our constant communication with the community, we found out that a large portion of our user base is actively using our documentation. Our user base is very active on the support chat, and we were convinced that most of the community members were just using this tool to gather information regarding Golem’s issues and installation processes. To have a single source of truth for All Things Golem was something high up our wishlist, as for some time we had high-level documentation on our website and more tech-savvy information on our GitHub. We wanted to merge those two worlds into one without sacrificing any of them.

Through our research to achieve this goal, we found out there was no need to reinvent the wheel. We started wondering: which web 2.0 projects have the best documentation standards, what can we learn from them, and how can we adapt it to our project? So we took it from there.

We asked several developers in the space which were to the best of their knowledge, great documentation examples, and most people agreed that Stripe, Twilio and Docker were some of the favorites. Through our research, we identified the best components of each and implemented those in our own docume...

Continue on blog.golemproject.net
Recent news
No posts found