Requesting New Repositories

This page describes the process for creating new repositories on our Gerrit server.

Steps for the request

Step 1

Gather the following information for the request:

• Name: A descriptive name, such as the Qt module name.
• Description: explain in one or two sentences what the code in the requested repository does.
• Responsible persons: Include names and their emails
• Repository name: A desired name including the namespace (please try to follow existing patterns). Keep in mind the discussion on the mailing list might end up in a new name for the repository.
  • All projects which are meant to ultimately end up in the qt distribution should start out in the qt/ namespace.
  • The playground/ namespace is for projects which don't fit any other category.
  • qt-labs/ is a semi-private namespace for employees of The Qt Company. Repositories here can be created without consulting the external community, but should be discussed on the internal development list. Using this namespace just as a shortcut to creating new Qt modules is discouraged (migration to the qt/ namespace requires community consultation anyway, and renaming repositories causes unnecessary hassle).
• If migrating from an existing repository, the URL of it, or explicitly say that you are not importing existing history
  • If you import verbatim history, it must comply with Qt's Commit Policy to a reasonable degree. Otherwise, you need to reshape or squash the history, and preferably submit it through the usual code review process.

Step 2

Send an email to the development@qt-project.org mailing list, describing what you plan to do and why you need a new repository for that. Note, that you need to subscribe to the list before sending messages to it.

Step 3

Once the discussion settles down and it is agreed that you should work in a new repository, create an issue under Quality Assurance Infrastructure (QTQAINFRA) project with the following information:

• Issue's type: Task
• Title: Repository request <your repo/project name>
• Component: Gerrit
• Description: The information you gathered in Step 1

An admin will proceed with the creation as soon as possible

Execution Details (for Admins)

• Mirroring to code.qt.io is automatic
• A mirror on GitHub needs to be created manually, and Gerrit's replication configuration may need to be adjusted
• Some TQtC sites maintain local mirrors which require manual action
• Repos in the qt/ namespace should be added to the qt5 super repo without much delay (typically without configuring them to be part of the default checkout yet).
• It is probably prudent to create a new product or component in JIRA