search

coreos / fedora-coreos-docs

Documentation for Fedora CoreOS
https://docs.fedoraproject.org/en-US/fedora-coreos/
Other
49 stars 119 forks source link

Document ways to contribute to FCOS #650

Open jlebon opened 2 weeks ago

jlebon commented 2 weeks ago

We should have a section somewhere (or maybe in the tracker?) for how to get more involved with FCOS. Some ideas, in order of commitment:

travier commented 2 weeks ago

More platforms

I started writing a disk image "convert" script to help with the new emerging platform flow.

It should make it easier for folks to test platforms for which we don't produce official FCOS images but have support for in Afterburn and Ignition.

Right now, the following platforms are almost ready and only need a bit of polish to go over the finish line:

Those need a bit more work but should be a reasonably small amount of work:

This one is more complex, but already has PRs in progress for afterburn & ignition:

Misc fixes

I also have this list of "things to fix" that should be accessible to get started:

hrismarin commented 2 weeks ago

I can try to start work on the first three points, i.e:

  • attend community meetings and provide input

  • help with community support on Matrix and the forum

  • help with testing (e.g. test day, bug fixes)

Since these points are already mentioned in FAQ: What are the communication channels around Fedora CoreOS?, I'm not sure if they would be a section in the docs and what information they should provide. Any advice would be greatly appreciated.

jlebon commented 2 weeks ago

@hrismarin Thanks for your interest!

Hmm, I wonder if it should just be a top-level "Contributing" page listed last (i.e. right after FAQ) in the nav bar.

hrismarin commented 2 weeks ago

I'm also in favor of this being a top-level "Contribute" page listed last. I will start working on the first three topics as I am aware of them.

I can also try to write about fixing bugs/adding features/new platforms.

I'm also particularly interested in being part of the FCOS release rotation. Unfortunately, what I know about it is only what I've read in the Matrix room when the team folks are coordinating. I think that's not much and I didn't explore further because I didn't even know that someone who wasn't part of the team could be part of the FCOS release rotation. Could you please direct me to where I can learn about the process so I can try to write about it and (hopefully) be a part of it, if I have the necessary skills of course.

Thank you!

jlebon commented 2 weeks ago

@hrismarin Nice! Maybe let's discuss this in the community meeting today. We'll need to come up with some sort of process for adding community members to the rotation. Probably something analogous to https://fedoraproject.org/wiki/Infrastructure/GettingStarted and https://fedoraproject.org/wiki/Infrastructure_Apprentice.

That said, a lot of contributions can be done from GitHub (certainly, bug fixes, features, and platform enablement) and that's actually where we need the most help.

c4rt0 commented 1 week ago

This was discussed at Fedora community meeting yesterday. We will add a new top level contributing page to our docs.