Google Summer of Docs project ideas page

[hanopcan]

We've just found out about the Google Summer of Docs application process which closes on April 2nd 2024. More info.

Quite a tight turn around time, but doable!

This issue is intended to act as an open discussion place for how our CO2.js project could participate in this, and what ideas we'd like to take forward.

[hanopcan]

Following a discussion between myself and @fershad , who is currently our technical writer and docs maintainer, we've got these broad ideas.

I'm sharing these here in case anyone in the wider CO2.js community would like to provide advice, or additional ideas on directions we could take with this proposal.

Idea 1. Expand docs on how to contribute

We've recently updated our longer-term vision for CO2.js and produced a roadmap in google slide format. One of our key themes in that roadmap is to get more active contributions into CO2.js and build up the community. (For clarity other themes are increase the number of methodologies available within CO2.js, increase the number of data sources/external APIs & deliver a better developer experience - that's four themes in total).

We think a key way of inviting more of the community to get involved is to make these ideas we have about the future direction of CO2.js more visible, easy to understand and actionable. In other words we want to make the contents of this new roadmap open. By doing that we can encourage more contributions, both in terms of time and funding, and also contributions that help steer the general direction of CO2.js.

Up until now we've been using a github project to house our public facing roadmap. This has been helpful to date but is limited in what we can do with it. It's also rather hidden. We also don't think a google slide deck is the right format either.

Instead we're inspired by what we see a fellow open source project, Wagtail, doing with their roadmap.

One of our ideas for this proposal, is to update our CO2.js documentation website with details about our roadmap. Our docs website has around 2,500 visits per month so this feels like the right place to surface our roadmap, with additional context to encourage more contributions.

We think we could do this by pulling issues directly from GitHub via API into the docs site. Automating this process should increase the chances of us keeping these docs up to date in the longer term. This approach would also allow us to add additional context about how our community can get involved to support and present them in a more engaging, visual way.

Idea 2. How can we use types/JSDoc to generate our own docs

Another idea is to explore automating the creation of our docs, specfically our methods documentation.

We've already received some mega helpful input from community contributor @sfishel18 on how we could build some type checking into the build process in this issue and accompanying PR, which we can use as a spring board to do this next step.

Right now this part of the docs is manually maintained. Given the above, our aim to increase contributions, an improvement like this would increase our chances of keeping our docs inline with (hopefully!) and increased volume on contributions.

Plus we should document how to write the in-code documentation (so meta!) so that others could contribute to adding in the necessary code so our automated processes can pick it up. I was involved in doing this within the WordPress community at a contributor day once, and it was a great way to make a quick contribution without it taking too long (once you had the initial set-up done of course).

[hanopcan]

For now I'm going to press ahead with scoping out if it's feasible for us to include both ideas in a proposal. The main thing I'll think through is how we'd do this in practice and how much budget it will take.

I'll be producing a public proposal document shortly which I'll link to here. I may well also spawn the two above ideas into issues of their own as well. Let's see how I get on with the time I have available 😁

[hanopcan]

Having worked through idea 1 in the proposal a bit more we've realised it's a bit outside the scope of what Google Summer of Docs is looking for. Instead, we're going to work on an idea 3 for the proposal.

Idea 3. Documentation for the docs site

This would major on an issue that's been hanging around since 2022, which is to make it much clearer and easier for how someone can contribute to the docs themselves. Eg to improve what we already have their, current tutorials for example, or add new ones in.

thegreenwebfoundation/developer-docs#2

[hanopcan]

Here's our final proposal which I'm submitting on behalf of the project now - https://docs.google.com/document/d/1wRHLRqo0PQ9DFHGuFH2AmlRv1i8N_zrcD_GWXntnDB0/edit?usp=sharing

[yashpandey06]

@hanopcan Kudos ....Co2.js is selected for GSOD 2024 ...looking forward to a healthy contribution ahead!!.

[yashpandey06]

@hanopcan any communication channel link would be appreciated where we have discussions about proposals and changes !!!

[himanshuaggar]

Hi @hanopcan , I am eager to contribute to the Green Web Foundation's mission with CO2. js in GSOD 2024. I believe my expertise will be instrumental in enhancing CO2.js and advancing digital sustainability for a fossil-free internet by 2030.
Excited to leverage my skills for a fossil-free internet by enhancing CO2.js and contributing to digital sustainability.

[fershad]

Hi all. Thanks for the messages of support. We only found out that we'd accepted into this great program yesterday, so we'll need some time to digest it and get our ducks in a row to move forwards with it.

[yashpandey06]

Hi all. Thanks for the messages of support. We only found out that we'd accepted into this great program yesterday, so we'll need some time to digest it and get our ducks in a row to move forwards with it.

😊 Sure

[ravjot07]

Hi @hanopcan , I'm impressed by the work you and your team are doing. I'm eager to learn more about the project and would appreciate any guidance on how to get started. I'm excited about the opportunity to contribute to the Green Web Foundation's mission with CO2.js for GSOD 2024.
/cc @fershad

[SafeEHA]

Super excited that your organization got accepted into the Season of Docs program this year, your project is exceptional and I would love to be assigned to work on this issue as a contributor for GSoD'24

[yashpandey06]

@hanopcan @fershad Hope you're well! Could you possibly share a link to a community platform (like Slack or Discord ) where we can all gather to discuss and exchange insights and ideas?

[yashpandey06]

@hanopcan @fershad it's been many days , we as a aspiring contributors still waiting for the application updates from your side , other organisations have started interviewing their potential candidates....I request you to provide further information regarding GSOD 2024 applications submission.

[fershad]

Hi @yashpandey06. At this time we are planning to allocate internal staff time to this project. We're still getting around to planning our work for this project. You can find out more information the project on our blog: https://www.thegreenwebfoundation.org/news/google-season-of-docs-co2-js-contributor-pathways/