Difference between revisions of "Phabricator callsign naming convention"
Jump to navigation
Jump to search
(add callsigns related to (git) annexes) |
(Tag as obsolete material) |
||
| (4 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| + | <div style="background: #ccc; color: red; font-weight: bold; width: 25em; border: solid black 1px; padding: 0.5em; margin: 4em 0;">This is obsolete material. As of 2023, the development is done using [https://gitlab.softwareheritage.org/ GitLab].</div> | ||
| + | |||
Each repository in [[Phabricator]] can be associated to a short [https://secure.phabricator.com/book/phabricator/article/diffusion/#repository-callsigns-and callsign]. You can choose one at repository creation time, or configuring it later. | Each repository in [[Phabricator]] can be associated to a short [https://secure.phabricator.com/book/phabricator/article/diffusion/#repository-callsigns-and callsign]. You can choose one at repository creation time, or configuring it later. | ||
| Line 7: | Line 9: | ||
* '''1st letter group''' (1 character) denotes the macro area the repository belongs to. It must best one of: | * '''1st letter group''' (1 character) denotes the macro area the repository belongs to. It must best one of: | ||
** A: non-software Annexes (e.g., raw data), including Git annexes | ** A: non-software Annexes (e.g., raw data), including Git annexes | ||
| + | ** C: CI related repositores ([https://docs.openstack.org/infra/jenkins-job-builder/ jjb], Dockerfiles, etc.) | ||
** D: Development repositories (e.g., Python modules) | ** D: Development repositories (e.g., Python modules) | ||
** M: project Management repositories | ** M: project Management repositories | ||
| Line 14: | Line 17: | ||
** X: eXternal projects, not strictly related to [[Software Heritage]], that might one day migrate elsewhere (e.g., Postgres extensions) | ** X: eXternal projects, not strictly related to [[Software Heritage]], that might one day migrate elsewhere (e.g., Postgres extensions) | ||
| − | === | + | === Annexes (1st letter: A) === |
* 2nd letter group | * 2nd letter group | ||
| Line 22: | Line 25: | ||
** AGPUB: public Git annex | ** AGPUB: public Git annex | ||
** AGPRV: private Git annex (Software Heritage team only) | ** AGPRV: private Git annex (Software Heritage team only) | ||
| + | |||
| + | === Continuous Integration (1st letter: C)=== | ||
=== Development (1st letter: D) === | === Development (1st letter: D) === | ||
| Line 29: | Line 34: | ||
** CL: cloners | ** CL: cloners | ||
** LS: listers | ** LS: listers | ||
| + | ** MF: metadata fetchers | ||
** W: web stuff | ** W: web stuff | ||
Latest revision as of 10:38, 14 February 2023
This is obsolete material. As of 2023, the development is done using GitLab.
Each repository in Phabricator can be associated to a short callsign. You can choose one at repository creation time, or configuring it later.
Here is the callsign naming convention adopted by Software Heritage.
General
- 1st letter group (1 character) denotes the macro area the repository belongs to. It must best one of:
- A: non-software Annexes (e.g., raw data), including Git annexes
- C: CI related repositores (jjb, Dockerfiles, etc.)
- D: Development repositories (e.g., Python modules)
- M: project Management repositories
- P: Packaging repositories (e.g., Debian packages)
- S: Sysadm repositories (e.g., Puppet stuff)
- T: Tools and utilities (misc)
- X: eXternal projects, not strictly related to Software Heritage, that might one day migrate elsewhere (e.g., Postgres extensions)
Annexes (1st letter: A)
- 2nd letter group
- AG: Git annexes
- notable repositories / exceptions
- AGPUB: public Git annex
- AGPRV: private Git annex (Software Heritage team only)
Continuous Integration (1st letter: C)
Development (1st letter: D)
- 2nd letter group
- LD: loaders
- CL: cloners
- LS: listers
- MF: metadata fetchers
- W: web stuff
- 3rd letter group: format loaders/cloners/listers act on
- DIR: directories
- DEB: Debian packages
- G: Git
- CG: Cgit
- ANT: Antepedia/Antelink
- postfix modifiers
- T: test stuff related to the corresponding repository without trailing T (e.g., DSTOT is test stuff for DSTO)
- notable repositories / exceptions
- DENV: development environment
- DCORE: core foundations
Management (1st letter: M)
- notable repositories / exceptions
- MGMT: catch-all management repository
- MSLD: talk slides
Packaging (1st letter: P)
- 2nd letter group
- FK: Flask-related packages
Sysadm (1st letter: S)
- 2nd letter group
- P: puppet stuff
- notable repositories / exceptions
- SPENV: puppet environment (get all the repos)
- SPSITE: puppet site
- SPPROF: puppet profiles
- SPROLE: puppet roles
Tools and utilities (1st letter: T)
External (1st letter: X)
Notable top-level repositories / exceptions
- PWD: passwords and credentials