Fedora Docs "HowTo" for casual contributions

7 clicks to create and propose a change in a Docs page

There is no preceding knowledge of git or merge requests necessary!

There is no risk of breaking anything …​ and all editing will be done in a GUI within your browser!

This HowTo is for GitLab-based pages only. If you were forwarded here by a link on any docs.fedoraproject.org page, you can be sure that you are in the right place!

If you have found something on a Docs page which you want to add, remove, change, or update, you will see three buttons on the top left which can be used to directly put forward your suggestion without knowledge of git or the structures with which the Docs pages are organized (repository structures). The buttons will automatically forward you correspondingly.

Left of the buttons, you see the Fedora release (e.g., "F36") to which the Docs page you have opened relates to. Docs pages relate to a specific Fedora release, although changes/updates can apply to several releases' Docs pages. If the latter is the case just choose any version that needs the change/update. If you do not know what version the update applies to, then ignore it for the time being. The left button forwards to the version history of the opened Docs page and is not relevant for you. The middle button forwards to "edit the page" that is currently opened, which is what you have to click to put forward your suggested change/update. The right button forwards to "report an issue" if you only want to make us aware of some need to change/update without making this yourself. Click the middle ("edit the page") button to go ahead with putting forward your suggestions:

1CUT changeIdentified
1A changeIdentified

Now log in to your GitLab account or create one if you do not have one yet (see the image below). Alternatively, you can also use the Fedora Account System to log into GitLab, but you have to do this in advance before clicking the "edit the page" button with the following link: https://gitlab.com/groups/fedora/-/saml/sso

If you have already a GitLab account and if you want to link it to your FAS account, you have to log into your existing GitLab account before you use the above FAS link!
2 GitLabSignin

Click now on the blue button "Open in Web IDE":

3 EditPage

Now, click on the button "fork" that has just appeared:

4 EditFork

Then, search the change/update within the Docs page you have now opened in the Web IDE and …​

5 webIDE

... make the change/update you want to suggest:

6 EditInWebIDE

As soon as any change has been made, the button "Create commit…​" will turn blue (see the image below). As soon as you have made all changes/updates you want to suggest, click the blue "Create commit…​" button:

7 DoneInWebIDE

You will now see the differences between the original version and your suggested version so that you can do a review:

8 CheckChange

After review, add a "Commit Message" briefly explaining what your suggestion is about. Then, click the blue "Commit" button:

9 CommitMessage

You are now at the final page to submit your Merge Request which contains a default Title and default Description both of which are likely to need to be changed:

A StartMergeRequest

You should adjust the Title and the Description of the page according to your suggestion (feel free to copy-paste the Commit Message) and then, scroll down to the blue "Create merge request" button and click it:

B EditTitleAndCreateMR

You are now done! You can ignore any issues about "branches". But feel free to …​


... add comments and discuss your suggestions with the Fedora Docs team. You can always return to this page later. Also, at this point feel free to note in a comment if you already know which Fedora releases are affected, but this is not obligatory:

D CommentsInMR
E MRwithComments

Thanks for your contribution!