To add a new guide, simply create a file under the “_guides” folder in GitLab.

The name of the file should look like this: title-to-be-used-in-url.md (don’t forget .md in the end!).

The content of the new file should look like this. Please copy the template below, paste it in GitLab’s new file, then edit according to your needs.

---
layout: guide
title: "Guide on how to do Y"
---

If you want to do Y, you must first do X.

After you have copied the template above, click this link to create a new file: Create a guide in GitLab