Struggling with Fedora's many platforms (as a newbie)

it’s a long known issue, they are reported
it’s knowing which tracker that’s been the hard part for me

I’ve been trying to do some “outreach” for Silverblue over the last week or two, and I’ve seen this quote - in one way or another - in a couple of places now. As it’s also a pain point for me, I thought I’d raise it - and yes, this is moaning, somewhat, but I think it’s productive to say it out loud.

It is very hard, especially for people not very engaged in the Fedora Project, to understand where anything is “done”. Off the top of my head there are three places you might file bugs against a Fedora Project (GitHub, GitLab, and Bugzilla), two additional platforms you might find code repositories (src.fpo and pagure.io), and two more platforms you might find (possibly out-of-date) documentation (wiki and docs). Builds could also be happening on GitHub, but could be happening on Koji - and I’m sure there’s a bunch I’ve missed (oh… mailing lists!).

It’s pretty common for people to file things in the “wrong place”, leading to poor interactions (especially with Silverblue, where it’s not clear if something is a Silverblue-specific bug or not). Because we’re all on different platforms it’s not possible to “move” an issue between projects, either.

I’m aware that the project takes a very hands-off approach to where things are hosted - in practice, this makes it really hard to engage with the Fedora Project as a new person and I think it’s creating some siloing as well - particularly between the “older” projects (on the self-hosted platforms) and “newer” projects (e.g. CoreOS and some of Silverblue, on GitHub).

I hope this comes across as a reflection on how, as a relative outsider, I’ve found working with Fedora - and I don’t think I’m alone (in fact, I’m sure I’m not alone). I hope this doesn’t come across as criticising anyone personally, or the intent of decisions made as a project - I understand the desire to keep people and teams using the tools they’re happy with, and of course any project that’s been going on for decades is going to have some “baggage” to deal with.

As the person complaining, I would like to propose an action (in an effort to make this productive, rather than because I necessarily think it’s the best one). Maybe it’s worth putting together a “Rationalisation Working Group” that focuses on documenting the landscape, seeking consensus on platform usage, and then doing the engineering work to meet that consensus. (Maybe this already exists? If so, where could I read about it?)

Other people probably have better ideas!

5 Likes

Fedora Apps Directory (map) helped me understand the public-facing portion of platforms when I was struggling with overwhelming scale of touch points in Fedora project. I agree it took time to get used to where to ask what…I still make mistakes, for example, when raising issue ticket, I escalated it onto a wrong repo.

As a side, an example you cited ‘bug report’ is a huge topic itself. Before I am certain it is a new bug to be reported to Bugzilla, there are a few steps to examine.

  • Search any related issues reported in Discussion/Ask: to make sure the issue is reproducible by other colleagues and there are similar issues being discussed
  • Check upstream repo and documentation: to avoid duplicated entry/post in Discussion and upstream repo

A documentation for bug reporting exists here. Please let me know if this requires an update.

2 Likes

Hello @jamesbelchamber ,
How about this link https://docs.fedoraproject.org/en-US/project/orgchart/ to help with the organizational structure aspect.

What you are experiencing here is a nature of Open Sourced Community Based Projects like :fedora: , things tend to happen at different places and times. Fortunately this place (Fedora’s Discourse instance) is becoming a central place of communication, so I am seeing more coherence in cross project aspects. There are still silo’s though.

As for issues specific to packages, they will always be on bugzilla AFAIK for the foreseeable future. For the other issues (and there are many for a platform the size of Fedora) things get rapidly divergent since the exploitation of one of our founding principles, First, seems to be one of the most successful aspects of the project → The latest and greatest seems to be offered regularly by the Fedora Project in reliably usable fashion.

You are not alone, I also had my fight (still today it is sometimes quite tricky).

About Silverblue or a traditional installation I just can propose you to install it on a virtual machine to see how both of them look like or work.

That is why we do have now discourse. This should help to see that there are newer ways to communicate with each other.

And beside of Github there is also Gitlab:

And if you see something like FAS it is now https://accounts.fedoraproject.org/ to do your profile and account settings.

Fedora is changing fast as also the infrastructure does :wink: