View source for Phabricator callsign naming convention

<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.

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 ([https://docs.openstack.org/infra/jenkins-job-builder/ 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


[[Category:Software development]]
[[Category:Phabricator]]