Hey friends,
The 5.0 alpha test build is out for testing! Great! Did you also have the
chance to attend any of the latest town halls?

Ok, it is time to say where I am going with this short intro...
Our friends from Constantia are working hard to help us spread the news and
promote all the great work we do in this community. They open Jira tickets
and PRs (not more than 1-2 per week, if any) to add announcements around
events, new features, town hall replays, etc. on the Cassandra website. It
requires a committer to do the review and push things through. The
publishing process on the Cassandra website underwent certain
transformations, and now it requires less effort (more on that below). I
wanted to raise the visibility and ask for committers' involvement; if you
see a ticket/PR and have 15 minutes, please, try to push it through.
Currently, some PRs can take up to 10 days to get committed. Is it possible
to cut that to 5 so we can spread any news on time?

For example, what it took me to correct a page on the website the other
week:

We have pre-commit CI in GitHub for cassandra-website commits; for example,
in CASSANDRA-18618 in my fork, the commits had checks like this:
https://github.com/ekaterinadimitrova2/cassandra-website/actions/runs/5825288289/job/15796474462

And it generates a (just top-level) website in the _generated branch, e.g.,
https://github.com/ekaterinadimitrova2/cassandra-website/blob/18738-trunk_generated/content/_/development/how_to_commit.html

I can take the raw URL of that and put it into raw.githack.com, e.g.,
https://raw.githack.com/ekaterinadimitrova2/cassandra-website/18738-trunk_generated/content/_/development/how_to_commit.html
to preview the generated output.

The rest is as before - we stage the changes and then push them live when
Jenkins completes. (full details in the website readme, I will also be
happy to guide anyone who is looking to lend a hand with this effort)

Feel free to let me know if you have any questions, concerns, or
suggestions to improve the process. Most discussions around the website
happen in ASF Slack #cassandra-website.

See you at the town hall on Thursday! :-)


Best regards,

Ekaterina

Reply via email to