Glossary gathering

[s-makin]

Let's kick off the glossary by gathering all our suggestions for things that need to be on it - all in one place. Once we have a decent sized list we can break it into concepts-with-explanations, acronyms, and other common terminology and put some pages in the guide.

I'll kick things off with some of the things we've discussed recently.

MOTU
upstream/downstream
binaries
archive
repositories
pockets
images
changelog

What else do you think we should have on there?

[dviererbe]

Here are a list of abbreviations that I see on a regular basis; I excluded terms that would technically break the Code of Conduct, because they are descending (e.g. lmgtfy):

    a11y
        Abbreviation for *accessibility*

    ACK
        Abbreviation for *acknowledge*

    AFAICS
        Abbreviation for *as far as I can see*

    AFAICT
        Abbreviation for *as far as I can tell*

    AFAIK
        Abbreviation for *as far as I know*

    AFAIR
        Abbreviation for *as far as I remember*

    AFAIU
        Abbreviation for *as far as I understand*

    AFK
        Abbreviation for *away from keyboard*

    AI
        Abbreviation for *action item*.

    AIUI
        Abbreviation for *as I understand it*

    AOB
        Abbreviation for *any other business*

    ASAP
        Abbreviation for *as soon as possible*

    AYT
        Abbreviation for *Are you there?*

    BAU
        Abbreviation for *business as usual*

    BBFN
        Abbreviation for *bye bye for now*

    BBIAB
        Abbreviation for *be back in a bit*

    BBL
        Abbreviation for *be back later*

    BBS
        Abbreviation for *be back soon*

    BIAB
        Abbreviation for *back in a bit*

    BRB
        Abbreviation for *be right back*

    BTW
        Abbreviation for *by the way*

    CTCP
        Abbreviation for *Care to chat privately?*

    DOG
        Abbreviation for *definition of great*

    DOD
        Abbreviation for *definition of done*

    DTRT
        Abbreviation for *do the right thing*

    EIB
        Abbreviation for *everything is broken*

    ELI5
        Abbreviation for *explain like I'm five*

    EOB
        Abbreviation for *end of business* (end of working day in the local timezone)

    EOD
        Abbreviation for *end of day*

    EOW
        Abbreviation for *end of week*

    FAO
        Abbreviation for *for the attention of*

    FAOD
        Abbreviation for *for avoidance of doubt*

    FAQ
        Abbreviation for *frequently asked questions*

    FSVO
        Abbreviation for *for some value of*

    FTFY
        Abbreviation for *fixed that for you*

    FTR
        Abbreviation for *for the record*

    FTW
        Abbreviation for *for the win*

    FWIK
        Abbreviation for *for what I know*

    FWIW
        Abbreviation for *for what I want* or *for what it's worth*

    FYI
        Abbreviation for *for your information*

    IANA
        Abbreviation for *I am not a ...*

    IANACP
        Abbreviation for *I am not a C programmer.*

    IANAL
        Abbreviation for *I am not a lawyer*

    IANAM
        Abbreviation for *I am not a manager*

    ICIWO
        Abbreviation for *in case it wasn't obvious*

    IDK
        Abbreviation for *I don't know*

    IIRC
        Abbreviation for *if I remember correctly* or *if I recall correctly*

    IIUC
        Abbreviation for *if I understand corectly*

    IKR
        Abbreviation for *I know, right?*

    IME
        Abbreviation for *in my experience*

    IMHO
        Abbreviation for *in my humble opinion*

    IMO
        Abbreviation for *in my opinion*

    IOW
        Abbreviation for *in other words*

    ISTR
        Abbreviation for *I seem to recall*

    JK
        Abbreviation for *just kidding*

    JOOC
        Abbreviation for *just out of curiosity*

    JOOI
        Abbreviation for *just out of interest*

    LGTM
        Abbreviation for *looks good to me*

    LOL
        Abbreviation for *laugh out loud*

    NAA
        Abbreviation for *not an acronym*

    NACK
        Abbreviation for *not acknowledge*

    o11y
        Abbreviation for *observability*

    OMW
        Abbreviation for *on my way*

    OOO
        Abbreviation for *out of office*

    OOS
        Abbreviation for *out of scope*

    PITA
        Abbreviation for *pain in the ass*

    POC
        Abbreviation for *proof of concept*

    PTO
        Abbreviation for *paid time off*

    Q&A
        Abbreviation for *questions and answers*

    QA
        Abbreviation for *quality assurance*

    RCA
        Abbreviation for *root cause analysis*

    RDS
        Abbreviation for *robust distro support*

    Recursion
        See Recursion

    RFI
        Abbreviation for *request for information*

    RFO
        Abbreviation for *reason for outage*

    RFP
        Abbreviation for *request for proposal*

    RGR
        Abbreviation for *roger (as in acknowledgement)*

    RPi
        Abbreviation for *Raspberry Pi*; a small single-board computer
        developed in the United Kingdom by the Raspberry Pi Foundation
        in association with Broadcom.

    RTM
        Abbreviation for *read the manual*

    RTS
        Abbreviation for *ready to ship*

    SOL
        Abbreviation for *sadly out of luck*

    SW
        Abbreviation for *software*

    TBF
        Abbreviation for *to be fair*

    TBH
        Abbreviation for *to be honest*

    TIA
        Abbreviation for *thanks in advance*

    TIL
        Abbreviation for *today I learned*

    TL;DR
        Abbreviation for *too long; didn't read*

    TOC
        Abbreviation for *table of contents*

    TTYL
        Abbreviation for *talk to you later*

    TY
        Abbreviation for *thank you*

    TYT
        Abbreviation for *take your time*

    TZ
        Abbreviation for *timezone*

    WDIK
        Abbreviation for *What do I know?*

    WDYM
        Abbreviation for *What do you mean?*

    WDYT
        Abbreviation for *What do you think?*

    WIP
        Abbreviation for *work in progress*

    WRT
        Abbreviation for *with respect to*

    WTG
        Abbreviation for *way to go*

    YAGNI
        Abbreviation for *you aren't gonna need it*

    YMMV
        Abbreviation for *your mileage may vary*

    YOLO
        Abbreviation for *You only live once!*

    YW
        Abbreviation for *You're welcome!*

[dviererbe]

I want to include them somewhere in the packaging guide, but not in the glossary list.

[dviererbe]

Note: the above terms are already in the definition list rST syntax.

[dviererbe]

This is the preliminary list of terms I want to cover:

.. glossary::

    AA
        Abbreviation for :term:`Archive Admin`

    ABI
        Abbreviation for :term:`Application Binary Interface`

    ANAIS
        Abbreviation for :term:`Architecture Not Allowed In Source`

    API
        Abbreviation for :term:`Application Programming Interface`

    Application Binary Interface
        *Work in Progress*

    Application Programming Interface
        *Work in Progress*

    APT
        Abbreviation for *Advanced Package Manager*. See :ref:`apt`

    Architecture Not Allowed In Source
        *Work in Progress*

    Archive
        *Work in Progress*

    Archive Admin
        *Work in Progress*

    Backports
        *Work in Progress*

    Bazaar
        *Work in Progress*

    Binaries
        *Work in Progress*

    Breezy
        A fork of the :term:`Bazaar` version control system.

    BTS
        Abbreviation for :term:`Bug Tracking System`

    Bug Tracking System
        *Work in Progress*

    BZR
        Abbreviation for :term:`Bazaar`

    Certified Ubuntu Engineer
        Develop and certify your skills on the world's most popular :term:`Linux` :term:`OS`. https://ubuntu.com/credentials

    Changelog
        *Work in Progress*

    CI
        Abbreviation for :term:`Continuous Integration`

    Circle of Friends
        The Ubuntu logo is called *Circle of Friends*, because it is derived
        from a picture that shows three friends extending their arms,
        overlapping in the shape of a circle. It should represent the
        `core values of Ubuntu <https://design.ubuntu.com/brand>`_:
        *Freedom*, *Reliable*, *Precise* and *Collaborative*.

    CLA
        Abbreviation for :term:`Contributor Licence Agreement`

    CLI
        Abbreviation for :term:`Command Line Interface`

    CoC
        Abbreviation for :term:`Code of Conduct`

    Code of Conduct
        *Work in Progress*

    CoF
        Abbreviation for :term:`Circle of Friends`

    Command Line Interface
        *Work in Progress*

    Common Vulnerabilities and Exposures
        *Work in Progress*

    Continuous Integration
        *Work in Progress*

    Contributor Licence Agreement
        *Work in Progress*

    Coordinated Release Date
        The date at which the details of a :term:`CVE` are to be publicly disclosed.

    Copyleft
        *Work in Progress*

    Copyright
        *Work in Progress*

    CRD
        Abbreviation for :term:`Coordinated Release Date`

    CUE
        Abbreviation for :term:`Certified Ubuntu Engineer`

    CVE
        Abbreviation for :term:`Common Vulnerabilities and Exposures`

    Debian
        *Work in Progress*

    Debian System Administration
        *Work in Progress*

    Developer Membership Board
        *Work in Progress* (see https://wiki.ubuntu.com/DeveloperMembershipBoard)

    DMB
        Abbreviation for :term:`Developer Membership Board`

    Downstream
        *Work in Progress*

    DSA
        Abbreviation for :term:`Debian System Administration`

    End of Life
        *Work in Progress*
    
    End of Line
        *Work in Progress*

    End of Support
        *Work in Progress*
    
    End-user license agreement
        *Work in Progress*

    EoL
        Abbreviation for either :term:`End of Life` or :term:`End of Line`

    EoS
        Abbreviation for :term:`End of Support`

    ESM
        Abbreviation for :term:`Extended Security Maintenance`

    EULA
        Abbreviation for :term:`End-user license agreement`

    Extended Security Maintenance
        *Work in Progress* (see https://ubuntu.com/esm)

    Failed to build from Source
        *Work in Progress*

    Failed to install
        *Work in Progress*

    Feature Freeze Exception
        *Work in Progress* (see https://wiki.ubuntu.com/FreezeExceptionProcess)

    Feature Request
        *Work in Progress*

    Federal Information Processing Standards
        *Work in Progress* (see https://en.wikipedia.org/wiki/Federal_Information_Processing_Standards)

    FFE
        Abbreviation for :term:`Feature Freeze Exception`

    FIPS
        Abbreviation for :term:`Federal Information Processing Standards`

    FOSS
        Abbreviation for :term:`Free and Open Source Software`

    FR
        Abbreviation for :term:`Feature Request`

    Free and Open Source Software
        *Work in Progress* (see https://en.wikipedia.org/wiki/Free_and_open-source_software)

    FTBFS
        Abbreviation for :term:`Failed to build from Source`

    FTI
        Abbreviation for :term:`Failed to install`

    GA
        Abbreviation for :term:`General Availability`

    GDPR
        Abbreviation for :term:`General Data Protection Regulation`

    General Availability
        *Work in Progress*

    General Data Protection Regulation
        *Work in Progress*

    General Public License
        *Work in Progress*

    git
        *Work in Progress*

    git-ubuntu
        *Work in Progress*

    GNU
        *Work in Progress*

    GPL
        Abbreviation for :term:`GNU` :term:`General Public License`

    GUI
        Abbreviation for Graphical :term:`User Interface`

    IC
        Abbreviation for :term:`Individual Contributor`

    ICE
        Abbreviation for :term:`Internal Compiler Error`

    IEEE
        Abbreviation for :term:`Institute of Electrical and Electronics Engineers`

    IRC
        Abbreviation for :term:`Internet Relay Chat`

    IRCC
        Abbreviation for :term:`Ubuntu IRC Council`

    Image
        *Work in Progress*

    Individual Contributor
        *Work in Progress*

    Institute of Electrical and Electronics Engineers
        *Work in Progress* (see https://www.ieee.org/)

    Intent to Package
        *Work in Progress* (see https://wiki.debian.org/ITP)

    Internal Compiler Error
        *Work in Progress*

    Internet Relay Chat
        Internet Relay Chat (:term:`IRC`)

    ITP
        Abbreviation for :term:`Intent to Package`

    Keyring
        *Work in Progress*

    Launchpad
        *Work in Progress*

    Linux
        *Work in Progress*

    Linux Containers
        See :term:`LXC`

    Long Term Support
        *Work in Progress*

    LP
        Abbreviation for :term:`Launchpad`

    LTS
        Abbreviation for :term:`Long Term Support`

    LXC
        :term:`Linux` Containers (see https://linuxcontainers.org/lxc/introduction/)

    LXD
        LXD is system container manager (see https://documentation.ubuntu.com/lxd/en/latest/)

    Main
        *Work in Progress* (the pocket)

    Main Inclusion Review
        *Work in Progress* (see https://github.com/canonical/ubuntu-mir)

    Maintainer
        *Work in Progress*

    Master of the Universe
        *Work in Progress*

    Merge Proposal
        *Work in Progress*

    Micro Release Exception
        See https://wiki.ubuntu.com/StableReleaseUpdates/MicroReleaseExceptions

    MIR
        Abbreviation for :term:`Main Inclusion Review`

    MOTU
        Abbreviation for :term:`Master of the Universe`

    MP
        Abbreviation for :term:`Merge Proposal`

    MRE
        Abbreviation for :term:`Micro Release Exception`

    Multiverse
        *Work in Progress* (the pocket)

    Not built from Source
        *Work in Progress*

    NBS
        Abbreviation for :term:`Not built from Source`

    Never Part Of A Stable Release
        *Work in Progress*

    NPOASR
        Abbreviation for :term:`Never Part Of A Stable Release`

    NVIU
        Abbreviation for :term:`Newer Version in Unstable`

    Newer Version in Unstable
        *Work in Progress*

    Open Source Software
        *Work in Progress*

    Operating System
        *Work in Progress*

    OS
        Abbreviation for :term:`Operating System`

    OSS
        Abbreviation for :term:`Open Source Software`

    Package
        *Work in Progress*

    Personal Package Archive
        *Work in Progress*

    PKCS
        Abbreviation for :term:`Public Key Cryptography Standards`

    Pocket
        *Work in Progress*

    POSIX
        Abbreviation for *Portable Operating System Interface*: A family of 
        standards specified by the :term:`IEEE` Computer Society for maintaining
        compatibility between :term:`Operating System`s. POSIX defines the :term:`API`,
        along with command line shells and utility interfaces, for software
        compatibility with variants of Unix and other :term:`Operating System`s.

    PPA
        Abbreviation for :term:`Personal Package Archive`

    PR
        Abbreviation for :term:`Pull Request`

    Public Key Cryptography Standards
        *Work in Progress* (see https://en.wikipedia.org/wiki/PKCS)

    Pull Request
        *Work in Progress*

    Real Time Operating System
        *Work in Progress*

    Request of Maintainer
        *Work in Progress*

    Request of Porter
        *Work in Progress*

    Requested by the QA team 
        *Work in Progress*

    Request of Security Team
        *Work in Progress*

    Request of Stable Release Manager
        *Work in Progress*

    Restricted
        *Work in Progress* (the pocket)

    RoM
        Abbreviation for :term:`Request of Maintainer`

    RoP
        Abbreviation for :term:`Request of Porter`

    RoQA
        Abbreviation for :term:`Requested by the QA team`

    RoSRM 
        Abbreviation for :term:`Request of Stable Release Manager`

    RoST
        Abbreviation for :term:`Request of Security Team`

    RTOS
        Abbreviation for :term:`Real Time Operating System` 

    Rules File
        *Work in Progress*

    Service-level Agreement
        *Work in Progress*

    Signing Key
        *Work in Progress*

    SLA
        Abbreviation for :term:`Service-level Agreement`

    SRU
        Abbreviation for :term:`Stable Release Update`

    Stable Release Update
        *Work in Progress*

    TLS
        Abbreviation for :term:`Transport Layer Security`

    TPM
        Abbreviation for :term:`Trusted Platform Module`

    Transport Layer Security
        *Work in Progress*

    Trusted Platform Module
        *Work in Progress*

    Ubuntu
        *Work in Progress*

    Ubuntu Cloud Archive
        *Work in Progress* (see https://wiki.ubuntu.com/OpenStack/CloudArchive)

    Ubuntu CVE Tracker
        *Work in Progress* (see https://launchpad.net/ubuntu-cve-tracker and https://ubuntu.com/security/cves)

    Ubuntu Developer Summit
        *Work in Progress* (see https://wiki.ubuntu.com/DeveloperSummit)

    Ubuntu IRC Council
        *Work in Progress* (see https://wiki.ubuntu.com/IRC/IrcCouncil)

    Ubuntu Pro
        *Work in Progress* (see https://ubuntu.com/pro)

    Ubuntu Summit
        See :term:`Ubuntu Developer Summit`

    UCA
        Abbreviation for :term:`Ubuntu Cloud Archive`

    UCT
        Abbreviation for :term:`Ubuntu CVE Tracker`

    UDS
        Abbreviation for :term:`Ubuntu Developer Summit`

    UI
        Abbreviation for :term:`User Interface`

    UIFe
        Abbreviation for :term:`User Interface Freeze Exception`

    Universe
        *Work in Progress* (the pocket)

    Unix
        *Work in Progress*

    Upstream
        *Work in Progress*

    US
        Abbreviation for :term:`Ubuntu Summit`

    User Interface
        *Work in Progress*

    User Interface Freeze Exception
        *Work in Progress*

    Waiting on Upstream
        *Work in Progress*

    Watch File
        *Work in Progress*

    WoU
        Abbreviation for :term:`Waiting on Upstream`

[dviererbe]

Also terms that should be covered are:

• tarball
• VCS (Version Control System)
• Copyright File
• Control File

[dviererbe]

I added the branch add-glossary.

[dviererbe]

There have bee no major negative comments so far. I will merge this branch now.