Make guides and howtos more visible?

[hamrheadcorvette (hammerhead corvette)]

@kparal

I wonder if we can make such guides more visible somehow?

Quick Docs

@kparal

But an easy-to-find list of howtos is definitely a good idea, in my eyes. We already have many of them in Fedora Quick Docs, but I understand that a lot of our users feel more comfortable writing the guide as a forum post, rather than submitting it as a quick doc. Also I find the Fedora Docs UI somewhat cumbersome to use.

The issue with the Quick Docs becomes maintenance and expectations.

Maintenance, because we have Quick Docs that are now out of scope with current releases.
Expectations, because the trend of the Quick Docs has changed and for many Quick Docs has become small historical post on a topic.

A Quick Doc should be a How-To, a way to quickly get answers to simple questions. Most of the Quick Docs belong in proper Fedora Documentation while other are lacking in updates or are no longer relevant due to the update process.

I have been attempting to get traction on this for about a month, but I think there needs to be some activity behind the curtain. My goal is to get these Quick Docs translated as well ! but looking through them, they need to be updated, and realigned with other Documentation before translating them.

I think the Docs need more community involvement, more active contributors.

This is part of my Request for TL4 Post. https://discussion.fedoraproject.org/t/formal-request-for-tl4/123548

@mattdm

I think if we’d had Discourse at the time, I would have located Quick Docs here. (There is a Docs Plugin which we have not activated…) But this is getting into something for docs-team — I’d hate for there to be two confusingly-similar sets of Quick Docs.

This is a reason why I have not launched some of the Docs I have written ( in 3 languages. . . ) already. Because we have the solution. Just the other day I used my personal Docs here on the forum to troubleshoot an issue with a non English speaker :

Problemas en arranque del SO al reiniciar

Tengo un problema con Fedora 40 Workstation, al reiniciar mi laptop (HP Laptop 14-dq2xxx , procesador Intel i3 11va gen ) esta se queda en el arranque y se queda congelado por lo que tengo que forzar el apagado, alguna solución por favor ? soy algo nuevo manejando el sistema Linux

This should be a Quick Doc on the Fedora Docs page but the English version would not be compatible, as it is overwhelming for a Layman/New User (or new user looking for a quick solution) which can be tense moments.