This year, we had the exciting opportunity to participate in Google’s Season of Docs (GSOD) 2024. GSOD is a funding program designed to support open source projects to allocate technical writing resources to improve the documentation for their project.
One of our key goals as part of this program is to drive an increase in community contributions to the CO2.js library itself, as well as to our Developer Documentation website. This has given us an opportunity to review our documentation and identify areas where we felt documentation was either missing, or could be improved upon.
Contribute to better documentation for CO2.js
Very early in the GSOD project, we identified that the Developer Documentation website repository was lacking some key information that would help external contributors commit updates to the project. To improve this, we updated the repository readme to provide more instructions to help developers setup, clone, and get started with the codebase. We also created some clear contribution guidelines to steer developers through the process of making a contribution.
Where we need some help
As a small team, we’ve got limited resources to dedicate to adding more useful content to our developer documentation. We’ve used our resources to get the basics in places such as introductory tutorials, guides, and explainers.
However, after reviewing the documentation for CO2.js we identified a handful of areas that we believe could be added to, or improved upon in the docs. This is where we could use some extra help!
We’ve created issues in our code repository that detail what we think could use more work. We’d deeply appreciate contributions from members of the community to help us make progress on them. They are:
- Demonstrate how to use CO2.js in different runtimes
- Document how to access methods within specific model classes
- Missing explainer for using other models/model versions in CO2.js tutorials
There are also a couple of open issues that members of the community have already started working on with open pull requests. They are:
- Add docs for usage of CO2.js within the impact framework (link to issue, link to pull request)
- Add a Click to Copy Button for Code Blocks in docs (link to issue, link to pull request)
If you have ideas for any of these issues, or would like to contribute some code to help us make progress on them, then please do leave a meaningful comment in the corresponding issue or pull request.
Hacktoberfest 2024
For those taking part in Hacktoberfest 2024, look out for those issues tagged with #hacktoberfest for the best places to start contributing. We’ve put together this handy filtered list to help you get started!
