Set up your authoring environment

Set up your environment for writing and previewing GitLab documentation.

You can use whichever tools you're most comfortable with. Use this guidance to help ensure you have the tools you need.

• Install a code editor, like VS Code or Sublime Text, to work with Markdown files.
• Install Git and add an SSH key to your GitLab profile.
• Install documentation linters and configure them in your code editor:
  • markdownlint
  • Vale
• If you're using VS Code, install the GitLab extension to get GitLab Duo Chat and other GitLab features in your editor.
• Set up the docs site to build locally.
• Optional. Install the Conventional Comments extension for Chrome. The plugin adds Conventional Comment buttons to GitLab comments.