Difference between revisions of "Phabricator callsign naming convention"

From Software Heritage Wiki
Jump to navigation Jump to search
(Tag as obsolete material)
 
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.
  

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