Difference between revisions of "Phabricator callsign naming convention"

From Software Heritage Wiki
Jump to navigation Jump to search
(Tag as obsolete material)
 
(2 intermediate revisions by one other user 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 32: 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