# Create documentation using Web IDE

Contribution to documentation is a great way to get familiar with the Fedora project and other contributors. From fixing typos to maintaining our documentation, you will find many tasks where you can help.

To contribute to the Docs team, it's helpful to familiarize yourself with the git-based workflow, as well as the AsciiDoc markup syntax.

The workflow with the GitLab makes it easier for anyone to contribute to the documentation.

The GitLab Web IDE is a built-in editor that manages documentation changes, contributions, and initiatives that are happening to a Fedora project.

Pre-requisite
Fedora Account System (FAS) account
Must have signed Fedora Project Contributor Agreement from FAS

### Step 1: Write documentation in AsciiDoc

AsciiDoc is a markup language to write content for Docs using a text editor. Writing in AsciiDoc helps focus on content and structure rather than presentation.

Open your favorite text editor that supports syntax highlighting for AsciiDoc
Write in plain text
Run spellchecker
Markup in AsciiDoc

### Step 2: Log in to GitLab via SAML SSO for Fedora

### Step 3: Go to project repository
Select Documentation Contributors Guide
Fedora Docs > Community and Tools Documentation > Documentation Contributors Guide

Request members of the docs group in Fedora Accounts
Someone with privileges will need to add you to the repository to get assigned to the Developer role. Request access to the Fedora Docs GitLab subgroup (by clicking xx)

Go to Repository > Files
Switch to stg branch (describe where to navigate)
Click Find File
Scroll down to find a file to edit/create
File path (Example)
modules/ROOT/pages/how-use-web-ide-ui.adoc

Select the file you want to change from the menu on the right.

### Step 4: Upload or edit
Click Web IDE
Upload .adoc file from local computer or

Click ‘Edit’: Make small changes to the existing file
In the upper right corner of the page, select Edit if it is visible.

Display source
Display rendered file

### Step 5: Create commit
If Web IDE
Edit, review and commit button on the left pane
Preview to see all the change
After making your changes, select Commit on the bottom-left to review the list of changed files.

If Edit,
Edit, review and commit button underneath

Add a "Commit Message"
Push it to stg branch