#498 Fedora KDE Documentation Project
Opened a year ago by farchord. Modified 6 months ago

I would like to create some documentation for Fedora KDE users, in the same vein as https://docs.fedoraproject.org/en-US/workstation-docs/ (but better, as this seems EXTREMELY barebones). But I would like some ideas.

Some ideas on my own:

1- How to submit bugs in the KDE Bugzilla/Fedora Bugzilla (Maybe how to tell if a bug applies to each...?)
2- A general list of all the KDE apps currently maintained in the repos and how they are classified (that's a huge one)
3- General SiG goals and our mandate
4- A link to our meeting room

This would also pave the way for the sig to (...maybe?) become an edition down the line. Even if we somehow fail in our efforts to become an edition, having those documentation pages can't hurt.


Metadata Update from @farchord:
- Issue assigned to farchord

a year ago

Metadata Update from @farchord:
- Issue set to the milestone: Fedora Linux 41
- Issue tagged with: experience, need-work, pending-action

a year ago

Those sounds like good ideas. Excepted for 1, I would add them to our existing KDE SIG Wiki page however instead of user docs.

For your suggestion 1 and user docs, I think we should ideally take the content from https://fedoraproject.org/wiki/KDE and make a proper doc out of it and replace the wiki page by a link to it.

+1, also agree to siosm's idea of taking the content from the wiki page and making a doc out of it, I am currently updating said page so it'll be far more up to date once something happens in pulling that content off the wiki and into Docs.

If this happens, I am also willing to make KDE equivalents to the Docs pages that reference GNOME (ie. updating Fedora via Discover, disabling tap to click, etc) and in general, KDE specific pages if needed.

I've launched an investigation on this. Seems that fedora-docs migrated over to gitlab some time ago. Essentially, we'D take their "template" and build upon it to make our docs, so we'd need a git forge in the mean time. Are we using Pagure, or are we making something on gitlab @ngompa ?

Fedora Docs can be anywhere, as it's decentralized. I've been holding off on the docs site stuff because of #510, as if that goes through, then I'd be creating one with that name instead.

Fedora Docs can be anywhere, as it's decentralized. I've been holding off on the docs site stuff because of #510, as if that goes through, then I'd be creating one with that name instead.

ok I'll wait then

Either that or I'll start building it on my own github and we can migrate when you'Re ready. That's actually more likely.

Created a repo on my own github: https://github.com/farchord/fedora-kde-docs if anyone wants commit rights, let me know.

I was thinking of creating a pagure repo, but if Fedora is walking away from pagure, ...

I honestly just didn't know where else to put it to be honest.

EPEL's docs are in pagure.
https://pagure.io/epel/blob/main/f/modules/ROOT
I see no reason not to have KDE's docs in pagure at this time.
Even if we try to guess which git Fedora is moving to, we have less than a 50% chance of getting it right and we'll have to move anyway.
So, just do it in pagure and if we have to move, we'll move then.

EPEL's docs are in pagure.
https://pagure.io/epel/blob/main/f/modules/ROOT
I see no reason not to have KDE's docs in pagure at this time.
Even if we try to guess which git Fedora is moving to, we have less than a 50% chance of getting it right and we'll have to move anyway.
So, just do it in pagure and if we have to move, we'll move then.

Neal didn't want to start working on this now, but I do want to start working on it. That's why I made an offsite copy to get a headstart. When we're ready to work on it, we can start from what I have and move it wherever we want.

Metadata Update from @timaeos:
- Issue set to the milestone: Fedora Linux 42 (was: Fedora Linux 41)

6 months ago

Log in to comment on this ticket.

Metadata