Using GitHub Templates to document things

Repository templates

You can create templates to model a specific repository setup when creating a new repository. The advantage of such a template is that you can provide a boilerplate for the README and any other files you would like your collaborators to provide when setting up a new project / repository.

To create a template repository you can either use an existing one or create a new one for this specific purpose. We are going to do the latter.

Let’s create a new repository as we have done previously we recommend adding the word “template” in the name so it makes its purpose more obvious

Now you can work on the content of the repository, for example adding a README with instructions to follow when setting up a new repository: https://github.com/awesomer-lab/repo-template

Once your repository is ready, you can go to the Settings tab in the taskbar of the repository and check the box Template repository under the repository name.

Note that you can keep editing the template repository after this step.

Now you can use your template when creating a new repository by selecting your template from the dropdown menu above the repository name. Note is might take a few seconds to fetch all your templates.

Voilà! Now you can create standardized repositories and documentation quite easily!! Note that under the name of the newly created repository from the template, it is mentioned that it was created from a template.


This work is licensed under CC BY 4.0

UCSB logo