Skip to content

Unify documentation on file templates

Everyone can contribute. Help move this issue forward while earning points, leveling up and collecting rewards.

Originally, this issue proposed unifying all types of template documentation.

After the discussion below, let's change this to reviewing documentation on various file templates.

From comment #293717 (comment 527376968):

  • Description templates are now part of File Templates.
  • Group file templates is the same feature as Instance template repository, the only difference is instance vs. group levels.
  • Dashboard templates are also part of File Templates.

If I were to consolidate things, it would be along the lines of -- Templates > File Templates where File Templates highlights Description Templates, Dashboard Templates, and the other file templates -- and that they are available at both the Instance and Group levels. The only difference between file templates and description templates is that only the non-description file templates are available in the Web IDE drop down.

In terms of the audience, it will be instance admins or group owners / maintainers

We have a few options to create templates currently in gitlab with ideas of more templates to be added. Should we consider adding a unified page to describe available templating in gitlab, perhaps with links to specific, more detailed pages for each type ?

Currently we have:

  • Project templates - e.g when creating a project you can chose a template
  • File templates - when creating/adding a file in the repository you can pick a template
  • Description templates - issues, mrs, (epics to come ?) when creating issue/mr

Potentially to be added:

Edited by 🤖 GitLab Bot 🤖