rust-gamedev / rust-gamedev.github.io

The repository for https://gamedev.rs
https://gamedev.rs
Apache License 2.0
392 stars 345 forks source link

Reducing Maintainer Burden #1417

Open AngelOnFira opened 11 months ago

AngelOnFira commented 11 months ago

So I just want to open this to discuss potential ways to streamline the process of editing the newsletter, and maybe analyze things that can be done better on the WG side as well.

  1. Try to automate more
    • Discussed in #1384
  2. Try to find more maintainers
    • This takes time, and finding people to contribute for longer periods often starts best by getting people to just be active periodically.
  3. Try to incentivize people who want contributions to start helping
    • I could probably find students at my university that would be interested in doing this. It's "lower hanging fruit" in terms of working on open source, but it's a great way to learn about Git flow.

Templated Sections

For items like the Game Dev Meetup and Veloren, I will always just copy content from the previous month and start from there. Maybe setting up a base template for each month that GitHub actions creates could speed things up a bit here? Sections could just be removed that don't have content for that month.

Related discussions

17cupsofcoffee commented 11 months ago

I think a lot of these discussions have focused on 'how do we make the current process work' - I think it might be also be useful to think about 'what could we change', unpalatable as some of these changes may be 😅

Reduce the level of detail (and/or standardize section content)

Compared with This Week In Rust (and other similar newsletters I've seen like Haskell Weekly), the individual sections in our newsletter are very long, and don't really have a standard format - or at least not one people stick to. Those other newsletters actually look a lot more like our 'extra news' section, now that I think about it.

While I don't think we should go quite as terse as TWIR (for one, we can't really avoid having images given that games are a visual medium!), I think we could potentially simplify contributing and reduce the amount of review comments if we were a bit more strict about the format.

(I would be much more in favour of this than relying on an LLM to 'pad out' sections, tbh - I feel that introducing any kind of AI tech to the process is going to make things worse, not better)

Be more strict about the cutoff dates (and don't do people's work for them)

A lot of the time people leave submitting their sections until the last minute, which leads to one of two scenarios:

IMO, we should just leave the section out if that happens, or move it to 'extra news'. It'll keep the schedule from slipping, and it gives people more incentive to actually submit their sections on time.

cybersoulK commented 11 months ago

is there a way we can monetize the newsletter?

i am not sure how much it can draw with donations alone. Or work with some institution to spread the newsletter more? Then we can pay the top contributors for their efforts, and there is more incentive to keep up. It's hard to replace them with a random guy at the university, because they are not into the rust ecosystem.

For example, the only reason i published Cybergate to this newsletter was because ozkriff researched, found me and invited me. AI or a random guy cannot replace this. And also if someone tries to submit a PR unrelated to games, or in another programming language, there must be someone with domain knowledge / community awareness that presses all the links and checks them out.

This is to keep the newsletter reputation at the highest level possible, so both readers and writers feel motivated to follow it. And also keeping it on time is extremely important. Skip a month if need be, but the issue to contribute should open at 25th of each month and be published for readers by 1st.

Vrixyz commented 9 months ago

I think a stricter release train is the way to go:

timeline
    title This Month in Rust Gamedev News
    1st : Release previous news entry!
        : (Release) social media posts, 
        : (Release) links to discussions
        : Add a draft of next month's newsletter
    2nd-27th : Contributor creates an issue
        : Community/editors review
        : Merge into source
    28th : PR freeze<br> Expect any pending PRs to be reported.
         : Last touches<br>global review pass

Any pending PRs after 28th should be treated as either:

If we want a less "strict" release train:

ElhamAryanpur commented 7 months ago

Oh I love this timeline, especially the future news section!

A strict timeline as proposed gives a lot of time for the entry authors too, along with people who want to start contributing.

janhohenheim commented 3 months ago

@Vrixyz great outline. I'd like to adhere as much as possible to this moving forward.

janhohenheim commented 3 months ago

Right now, the call for actions + reduced lints is working really well. We're getting quite a few contributions from interested people without pinging them first, and most passed the CI on the first try or only required trivial edits by me that took about 20 seconds, which is completely fine for me. The schedule outlined by @Vrixyz is now in place, so I won't accept any contributions after the 28th. They're part of the next month. I'll see how high the burden is once the editing period starts, but it seems to me like this issue can be closed in favor of only leaving #1384 :) I'll come back after the April newsletter has shipped and we started the May call for submissions.