7-click HowTo for Fedora Docs

I think we should not shrink them too much, too keep everything visible as good as possible. But I think that decreasing the size a bit makes sense. At the moment, it is a bit like “monster images” with some tiny text in between.

I’m not sure if I know what you mean. I mentioned the GitLab account as primary login instance because this is the easiest way (default by the Docs web interface) and some have GitLab already (I tested it, to put forward MR you do not need the Fedora Account System). I also mentioned the Fedora Account System login (including the link) as alternative for those who want to use it, but if someone has a Fedora account in advance, I assumed it is not necessary to elaborate how to use the FAS. Anyway, using the FAS for our Docs GitLab increases complexity and the number of steps, so I choose to not focus this method for “sporadic contributors” - of course we can discuss and change that. Absolutely necessary is FAS only for those who accept/approve the MR, which is the permanent Docs team. If someone has not yet a FAS account, I think a GitLab acc makes more sense for now anyway. Or did you mean something else?



But before I start to do formatting and such, it might be clarified how (which is linked to where) we present the HowTo: do we make a PDF to which it can be linked? Shall it stay an md file as it is at the moment? Or do we make it itself a Docs file with AsciiDoc? Originally, I intended it to be a PDF (out of habit, and this seems to be something everyone is used to : ), but now that you brought up the idea of integrating it into Docs, I am open to that, too. That question should be considered before starting to do formatting :slight_smile: