Merge pull request #261 from Sarka-Jana/glossary-rhel-software-management

Add new terms for glossary: RHEL software management

Author: bburt-rh

supplementary_style_guide/glossary_terms_conventions/general_conventions/a.adoc

@@ -149,6 +149,7 @@ _Specify the system architecture of your cluster, such as `x86_64` or `aarch64`.
 *See also*: xref:activemq-artemis[ActiveMQ Artemis], xref:jboss-eap-messaging[JBoss EAP messaging]
 
 // EAP: Added "In Red Hat JBoss Enterprise Application Platform,"
+
 [[activemq-artemis]]
 ==== image:images/caution.png[with caution] ActiveMQ Artemis (noun)
 *Description*: In Red Hat JBoss Enterprise Application Platform, use "ActiveMQ Artemis" only when describing the technology used to implement the built-in messaging for JBoss EAP.
@@ -409,6 +410,16 @@ An Ansible task is a set of instructions to achieve a state defined, in its broa
 
 *See also*: xref:app[app]
 
+[[application-stream]]
+==== image:images/yes.png[yes] Application Stream (noun)
+*Description*: _Application Streams_ are multiple versions of Red Hat Enterprise Linux user-space components that are delivered and updated more frequently than the core operating system packages. Application Streams can be packaged as RPM packages, modules, or Software Collections. Do not confuse Application Streams with "AppStream", the repository through which Application Streams and other components are distributed.
+
+*Use it*: yes
+
+*Incorrect forms*: AppStream, application stream, Application stream
+
+*See also*: xref:appstream-repository[AppStream repository]
+
 [[applixware]]
 ==== image:images/yes.png[yes] Applixware (noun)
 *Description*: _Applixware_ is a suite of proprietary modular applications for Linux.
@@ -419,6 +430,16 @@ An Ansible task is a set of instructions to achieve a state defined, in its broa
 
 *See also*:
 
+[[appstream-repository]]
+==== image:images/yes.png[yes] AppStream repository (noun)
+*Description*: The _AppStream repository_  distributes RHEL content as Application Streams and other components. Do not confuse the AppStream repository with the Application Streams that it distributes.
+
+*Use it*: yes
+
+*Incorrect forms*: Appstream, appstream, Application Stream
+
+*See also*: xref:application-stream[Application Stream]
+
 [[arp]]
 ==== image:images/yes.png[yes] ARP (noun)
 *Description*: Within a subnet of an Ethernet network, hosts use the Address Resolution Protocol (_ARP_) to discover the Media Access Control (MAC) address that is associated with an IPv4 address. In IPv6 networks, the Neighbor Discovery Protocol (NDP) provides the functionality of ARP.
@@ -568,6 +589,7 @@ An Ansible task is a set of instructions to achieve a state defined, in its broa
 
 *See also*:  xref:xplat[Microsoft Azure Cross-Platform Command-Line Interface]
 
+
 [[arm64]]
 ==== image:images/yes.png[yes] ARM64 (noun)
 *Description*: A 64-bit version of the ARM architecture. Use this term for OpenShift Container Platform (OCP) attributes, Kubernetes, Operators, APIs, and CLI objects. Use this format in general sentences when referring to OCP features.

supplementary_style_guide/glossary_terms_conventions/general_conventions/b.adoc

@@ -71,6 +71,16 @@
 
 *See also*: xref:distinguished-name[distinguished name]
 
+[[baseos-repository]]
+==== image:images/yes.png[yes] BaseOS repository (noun)
+*Description*: In Red Hat Enterprise Linux, the  _BaseOS repository_ contains the core set of the underlying operating system functionality that provides the foundation for all installations.
+
+*Use it*: yes
+
+*Incorrect forms*: Baseos, baseos, baseOS
+
+*See also*:
+
 [[basic-http-authentication]]
 ==== image:images/yes.png[yes] Basic HTTP authentication (noun)
 *Description*: _Basic HTTP authentication_, or _Basic authentication_, is an authorization scheme that uses HTTP to send login credentials encoded in Base64.
@@ -147,6 +157,16 @@ The practice of having both modes together is often referred to as _hybrid_, _ag
 
 *See also*:
 
+[[binary-rpm]]
+==== image:images/yes.png[yes] binary RPM (noun)
+*Description*: A _binary RPM_ is an RPM package that contains the binaries built from sources and patches.
+
+*Use it*: yes
+
+*Incorrect forms*:
+
+*See also*: xref:rpm[RPM]
+
 [[bind]]
 ==== image:images/yes.png[yes] BIND (noun)
 *Description*: Use "BIND" when referring to the DNS software.
@@ -212,6 +232,16 @@ Do not use "BIOS" as a generic term to refer to computer firmware. Use "firmware
 
 *See also*: xref:filestore[FileStore], xref:object-store[Object Store]
 
+[[boolean-dependencies]]
+==== image:images/yes.png[yes] Boolean dependencies (noun)
+*Description*: In Red Hat Enterprise Linux, _Boolean dependencies_ are Boolean expressions such as `if`, `and`, `or`, and other expressions that are used in the `Requires`, `Conflicts`, and `Weak` dependency directives. Boolean dependencies are also known as _Rich dependencies_.
+
+*Use it*: yes
+
+*Incorrect forms*:
+
+*See also*: xref:weak-dependencies[Weak dependencies]
+
 [[boot-disk]]
 ==== image:images/yes.png[yes] boot disk (noun)
 *Description*: A _boot disk_ is a disk used to start a computer.
@@ -485,3 +515,13 @@ Do not use "BIOS" as a generic term to refer to computer firmware. Use "firmware
 *Incorrect forms*: byte code
 
 *See also*:
+
+[[byte-compiled-program]]
+==== image:images/yes.png[yes] byte-compiled program (noun)
+*Description*: _Byte-compiled programs_ are programs that must be compiled into bytecode before they can run in a language virtual machine.
+
+*Use it*: yes
+
+*Incorrect forms*:
+
+*See also*: xref:interpreted-code[interpreted code]

supplementary_style_guide/glossary_terms_conventions/general_conventions/c.adoc

@@ -398,6 +398,16 @@
 
 *See also*:
 
+[[codeready-linux-builder-repository]]
+==== image:images/caution.png[with caution] CodeReady Linux Builder repository (noun)
+*Description*: In Red Hat Enterpise Linux, the _CodeReady Linux Builder repository_ provides additional packages for use by developers. Red Hat does not support packages included in the CodeReady Linux Builder repository. Do not use a shortened form of this term. Always mention that packages in this repository are unsupported.
+
+*Use it*: with caution
+
+*Incorrect forms*: codeready Linux builder, CRB 
+
+*See also*:
+
 [[codebase]]
 ==== image:images/yes.png[yes] codebase (noun)
 *Description*: A _codebase_ is a complete collection of source code for a software component, application, or system. Write as shown: one word.

supplementary_style_guide/glossary_terms_conventions/general_conventions/d.adoc

@@ -221,7 +221,7 @@ The API object for a deployment can be either a Kubernetes-native `Deployment` o
 // EAP: Added "In Red Hat JBoss Enterprise Application Platform,"
 [[deployment-scanner]]
 ==== image:images/yes.png[yes] deployment-scanner subsystem (noun)
-*Description*: In Red Hat JBoss Enterprise Application Platform, the _deployment-scanner subsystem_ is used to configure scanners to check for applications to deploy. In general text, write in lowercase as two words separated by a hyphen. Use "Deployment Scanners subsystem" when referring to the `deployment-scanner` subsystem in titles and headings. When writing the term in its heading form, ensure that you include a plural 's'.
+*Description*: In Red Hat JBoss Enterprise Application Platform, the _deployment-scanner subsystem_ is used to configure scanners to check for applications to deploy. In general text, write in lowercase as two words separated by a hyphen. Use "Deployment Scanners subsystem" when referring to the `deployment-scanner` subsystem in titles and headings. When writing the term in its heading form, ensure that you include a plural 's'.
 
 *Use it*: yes
 
@@ -369,7 +369,6 @@ The API object for a deployment can be either a Kubernetes-native `Deployment` o
 *See also*:
 
 // RHEL: Added "In Red Hat Enterprise Linux,"; Lowercased entry to "directory server" and updated in description
-// TODO: See if it was right to lowercase this
 [[directory-server]]
 ==== image:images/yes.png[yes] directory server (noun)
 *Description*: In Red Hat Enterprise Linux, a _directory server_ centralizes user identity and application information. It provides an operating system-independent, network-based registry for storing application settings, user profiles, group data, policies, and access control information. Each resource on the network is considered an object by the directory server. Information about a particular resource is stored as a collection of attributes associated with that resource or object.
@@ -446,6 +445,16 @@ Red Hat Directory Server conforms to LDAP standards.
 
 *See also*:
 
+[[dnf-automatic]]
+==== image:images/yes.png[yes] DNF Automatic (noun)
+*Description*: Use _DNF Automatic_ to refer to a Red Hat Enterprise Linux command-line interface suited for automatic and regular package updates.
+
+*Use it*: yes
+
+*Incorrect forms*: DNF automatic, dnf automatic
+
+*See also*:
+
 [[dns]]
 ==== image:images/yes.png[yes] DNS (noun)
 *Description*: _DNS_ is an abbreviation for "Domain Name System" or "Domain Name Service", a service that translates domain names into IP addresses and vice versa.
@@ -492,7 +501,7 @@ Red Hat Directory Server conforms to LDAP standards.
 // RHEL: Added "In Red Hat Enterprise Linux,"
 [[domain-controller]]
 ==== image:images/yes.png[yes] domain controller (noun)
-*Description*: In Red Hat Enterprise Linux, a _domain controller (DC)_ is a host that responds to security authentication requests within a domain and controls access to resources in that domain.
+*Description*: In Red Hat Enterprise Linux, a _domain controller (DC)_ is a host that responds to security authentication requests within a domain and controls access to resources in that domain. IdM servers work as DCs for the IdM domain. A DC authenticates users, stores user account information and enforces security policy for a domain. When a user logs into a domain, the DC authenticates and validates their credentials and either allows or denies access.
 
 *Use it*: yes
 
@@ -521,7 +530,6 @@ Red Hat Directory Server conforms to LDAP standards.
 
 *See also*:
 
-
 [[download-n]]
 ==== image:images/yes.png[yes] download (noun)
 *Description*: Use "download" as a noun when referring to software, data, and so on that is being retrieved from another computer.

supplementary_style_guide/glossary_terms_conventions/general_conventions/f.adoc

@@ -86,6 +86,16 @@ Use the hyphenated "fault-tolerant" when using it as an adjective.
 
 *See also*: xref:bluestore[BlueStore]
 
+[[file-trigger-directive]]
+==== image:images/yes.png[yes] file trigger directive (noun)
+*Description*: In Red Hat Enterprise Linux, a _file trigger directive_ is a special form of a transaction scriptlet that runs conditionally when matching files from other packages are installed or uninstalled.
+
+*Use it*: yes
+
+*Incorrect forms*:
+
+*See also*:
+
 [[firewalld]]
 ==== image:images/yes.png[yes] firewalld (noun)
 *Description*: The _firewalld_ service provides a dynamically managed firewall with support for zones that define the trust level of network connections or interfaces. Write as shown (all lowercase).

supplementary_style_guide/glossary_terms_conventions/general_conventions/i.adoc

@@ -524,6 +524,16 @@ _This feature can run only on Intel 64 processors_
 
 *See also*:
 
+[[interpreted-code]]
+==== image:images/yes.png[yes] interpreted code (noun)
+*Description*: In Red Hat Enterprise Linux, _interpreted code_ is source code that runs step-by-step, without prior transformations by a language interpreter or a language virtual machine.
+
+*Use it*: yes
+
+*Incorrect forms*:
+
+*See also*: xref:raw-interpreted-program[raw-interpreted program], xref:byte-compiled-program[byte-compiled program]
+
 // RHEL: Added "In Red Hat Enterprise Linux, an inventory is"
 [[inventory]]
 ==== image:images/yes.png[yes] inventory (noun)

supplementary_style_guide/glossary_terms_conventions/general_conventions/m.adoc

@@ -474,6 +474,36 @@ Azure CLI 2.0 is the most current command-line interface and is replacing Xplat-
 
 *See also*:
 
+[[module]]
+==== image:images/yes.png[yes] module (noun)
+*Description*: In Red Hat Enterprise Linux, a _module_ is a collection of packages representing a logical unit: an application, a language stack, a database, or a set of tools. These packages are built, tested, and released together.
+
+*Use it*: yes
+
+*Incorrect forms*:
+
+*See also*:
+
+[[module-profile]]
+==== image:images/yes.png[yes] module profile (noun)
+*Description*: In Red Hat Enterprise Linux, a _module profile_ is a list of recommended packages to be installed together for a particular use case such as for a server, client, development, or minimal installation. These package lists can contain packages outside the module stream, usually from the BaseOS repository or the dependencies of the stream.
+
+*Use it*: yes
+
+*Incorrect forms*:
+
+*See also*: xref:baseos-repository[BaseOS repository]
+
+[[module-stream]]
+==== image:images/yes.png[yes] module stream (noun)
+*Description*: In Red Hat Enterprise Linux, _module streams_ are filters that can be thought of as virtual repositories in the AppStream physical repository. Module streams represent versions of the Application Stream components.
+
+*Use it*: yes
+
+*Incorrect forms*:
+
+*See also*:
+
 // RHV: Added "In Red Hat Virtualization,"
 [[mom]]
 ==== image:images/yes.png[yes] MOM (noun)

supplementary_style_guide/glossary_terms_conventions/general_conventions/n.adoc

@@ -63,6 +63,16 @@
 
 *See also*: xref:management-cli[management CLI]
 
+[[natively-compiled-code]]
+==== image:images/yes.png[yes] natively compiled code (noun)
+*Description*: _Natively compiled code_ is code written in a programming language that compiles to machine code with a resulting binary executable file. Such code can be run standalone.
+
+*Use it*: yes
+
+*Incorrect forms*: natively-compiled code
+
+*See also*: 
+
 [[need]]
 ==== image:images/yes.png[yes] need (verb)
 *Description*: Use "need" instead of "desire" or "wish". Use "want" when the reader's actions are optional; that is, one might not need something but might still want something.

supplementary_style_guide/glossary_terms_conventions/general_conventions/r.adoc

@@ -63,7 +63,6 @@
 
 [[raw-data]]
 ==== image:images/yes.png[yes] raw data (noun)
-
 *Description*: _Raw data_ is information that has not been organized, formatted, or analyzed.
 
 *Use it*: yes
@@ -72,6 +71,17 @@
 
 *See also*:
 
+[[raw-interpreted-program]]
+==== image:images/yes.png[yes] raw-interpreted program (noun)
+
+*Description*: A _Raw-interpreted program_ is a program that does not need to be compiled and is directly run by a language interpreter.
+
+*Use it*: yes
+
+*Incorrect forms*:
+
+*See also*: xref:interpreted-code[interpreted code]
+
 // Ceph: Added "In Red Hat Ceph Storage, RBD is an"
 [[RBD]]
 ==== image:images/yes.png[yes] RBD (noun)
@@ -407,16 +417,6 @@ Always use the approved product name _Red Hat build of OpenJDK_ instead.
 
 *See also*: xref:red-hat-network-proxy-server[Red Hat Network Proxy Server]
 
-[[red-hat-network-proxy-server]]
-==== image:images/yes.png[yes] Red Hat Network Proxy Server (noun)
-*Description*: Use "Red Hat Network Proxy Server" for the first occurrence; use "RHN Proxy Server" or omit the word "Server" from any of the previous constructions on subsequent mentions. With sufficient context, you can refer to "Satellite" and "Proxy", for example, "RHN Satellite and Proxy" instead of "RHN Satellite and RHN Proxy".
-
-*Use it*: yes
-
-*Incorrect forms*: Red Hat Proxy (Server)
-
-*See also*: xref:red-hat-network-satellite-server[Red Hat Network Satellite Server]
-
 [[red-hat-openjdk]]
 ==== image:images/no.png[no] Red Hat OpenJDK (noun)
 *Description*: Do not use _Red Hat OpenJDK_ to refer to the Red Hat distribution of the Open Java Development Kit (OpenJDK).
@@ -431,6 +431,16 @@ Always use the approved product name _Red Hat build of OpenJDK_ instead.
 
 *See also*: xref:red-hat-build-openjdk[Red Hat build of OpenJDK], xref:red-hat-java[Red Hat Java]
 
+[[red-hat-network-proxy-server]]
+==== image:images/yes.png[yes] Red Hat Network Proxy Server (noun)
+*Description*: Use "Red Hat Network Proxy Server" for the first occurrence; use "RHN Proxy Server" or omit the word "Server" from any of the previous constructions on subsequent mentions. With sufficient context, you can refer to "Satellite" and "Proxy", for example, "RHN Satellite and Proxy" instead of "RHN Satellite and RHN Proxy".
+
+*Use it*: yes
+
+*Incorrect forms*: Red Hat Proxy (Server)
+
+*See also*: xref:red-hat-network-satellite-server[Red Hat Network Satellite Server]
+
 // OCP: General; kept as is
 [[red-hat-openshift-cluster-manager]]
 ==== image:images/yes.png[yes] Red Hat OpenShift Cluster Manager (noun)
@@ -839,6 +849,16 @@ Use the name of the tab when you refer to it, for example, "the *Storage* tab".
 
 *See also*:
 
+[[rolling-stream]]
+==== image:images/yes.png[yes] Rolling Stream (noun)
+*Description*: _Rolling Streams_, also referred to as Rolling Application Streams, include Red Hat Enterprise Linux tools and applications that are updated frequently. Later versions of these streams replace earlier versions. Therefore, only one version at a time is supported.
+
+*Use it*: yes
+
+*Incorrect forms*: rolling stream
+
+*See also*:
+
 [[roll-out]]
 ==== image:images/yes.png[yes] roll out (verb)
 *Description*: In marketing, to _roll out_ a product means to introduce it in stages to the public. In computing, to roll out software means to install a new product across a  network.
@@ -997,14 +1017,24 @@ Use the name of the tab when you refer to it, for example, "the *Storage* tab".
 
 [[rpm]]
 ==== image:images/yes.png[yes] RPM (noun)
-*Description*: _RPM_ is the recursive initialism for the _RPM Package Manager_. RPM manages files in the RPM format, known as RPM packages. RPM packages are known informally as `rpm` files, but this informal usage is not used in Red Hat documentation to avoid confusion with the command name. Files in RPM format are referred to as "RPM packages".
+*Description*: _RPM_ is the recursive initialism for the _RPM Package Manager_. RPM manages files in the RPM format. Those files are referred to as "RPM packages". Even though RPM packages are known informally as `rpm` files, do not use this informal term in Red Hat documentation to avoid confusion with the command name.
 
 *Use it*: yes
 
 *Incorrect forms*: rpm
 
 *See also*:
 
+[[rpm-macro]]
+==== image:images/yes.png[yes] RPM macro (noun)
+*Description*: An _RPM macro_ is a straight text substitution that can be conditionally assigned based on the optional evaluation of a statement when certain built-in functionality is used. RPM macros help to make package maintenance simpler and to automate certain repetitive tasks or patterns that are common across all types of packages.
+
+*Use it*: yes
+
+*Incorrect forms*:
+
+*See also*:
+
 // RHEL: General; kept as is
 [[rpm-ostree]]
 ==== image:images/yes.png[yes] rpm-ostree (noun)