I have drafted a Quick HowTo (how to edit a Docs page with 7 clicks) that aims to lower the entry barrier to contributing to Docs, with a focus on sporadic contributors outside the Docs team. This HowTo is based upon the experiences gathered/summed in this thread (thanks again to the Ask.fp regulars/leaders for your incentives!). The HowTo also aims a bit to tackle some of the issues mentioned in the not using git thread.
More precisely, the HowTo aims to…
… make clear to potential contributors that this is a graphical browser-based workflow that does NOT need knowledge about about git or merge requests,
… make clear to potential contributors that it is NOT necessary to know the structures of the git repositories of Fedora Docs,
… make clear to potential contributors that it is NOT necessary to search/identify the related repository before a contribution can be done,
… make clear that this does not take much time: in the end, it is 7 clicks plus writing some text, and
… you cannot break anything, so do not worry!
These are widely the (imho false) presumptions I collected from people who have a lot of valuable Fedora and Linux knowledge (enabling them to offer valuable Docs contributions) but who have not yet worked deeply with the Docs or with git.
The draft is not yet formatted (including the images), and the texts are yet very rough as well, but it is something to start a discussion about (updated 20220720):
PDF draft (updated 20220720):
Currently, I think it makes sense to remove the image 5-webIDE.png and to merge the text below and above this image.
One big issue remains that cannot be solved by such a HowTo itself:
In the conversations I had about this, I came to the conclusion that the false presumptions make people assume in advance that this would be too much work or too time intensive, so that many do not even look for/in a HowTo. Obviously, the best HowTo cannot make a difference if no one looks inside this HowTo.
Therefore, it might makes sense to put this HowTo in place at a point where people are directly made aware of it, and it has to appear in a way that makes some points clear: it is easy and fast to edit a Docs page! An “image” button cannot fulfill this purpose. Maybe a “text” button with a corresponding “HowTo: 7-clicks to an edit” text next to the existing buttons makes sense? This makes the potential contributor aware of it fully passively (so that no active action is necessary: not even to put the cursor on an image until some “edit the page” text appears or so). Also, it might make sense to remove the “History” button at all?
Feel free to discuss or to challenge my approach!