docs: add glossary for Adsys #169
+46
−4
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
|
|
@@ -7,7 +7,49 @@ concepts, tools or packages that a Windows users might | |||||
| not be familiar with. | ||||||
| --> | ||||||
|
|
||||||
| - [**adcli**](https://manpages.ubuntu.com/manpages/xenial/man8/adcli.8.html): A command-line tool for managing Active Directory (AD) domain membership on Linux. | ||||||
| - **Adsys**: A tool that allows system administrators to manage Ubuntu machines using Microsoft Active Directory (AD). | ||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||
| - [**adsysctl**](https://documentation.ubuntu.com/adsys/en/latest/reference/adsysctl-cli/): A command-line utility for interacting with the Adsys service in Ubuntu. | ||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||
| - **apt (Advanced Package Tool)**: A package management system used in Debian-based distributions like Ubuntu to install, update, and remove software. | ||||||
| - [**AppArmor**](https://documentation.ubuntu.com/server/how-to/security/apparmor/): A Linux security module that enforces mandatory access control policies on programs to limit their capabilities. | ||||||
|
There was a problem hiding this comment. this is good and nice use of a link too. make sure for other example, such as gsettings and dconf, that you consider whether there is any appropriate link that could be provided within the docs. |
||||||
|
|
||||||
| - **buffer**: A temporary data storage area used to manage data flow between processes, hardware, or networks. | ||||||
|
There was a problem hiding this comment. maybe this is not needed? seems like a very general term. |
||||||
|
|
||||||
| - [**certmonger**](https://manpages.ubuntu.com/manpages/focal/man8/certmonger.8.html): A service that monitors and renews certificates, commonly used in enterprise environments. | ||||||
|
|
||||||
| - **D-Bus call**: A command or API request used to communicate with system services via D-Bus, a message bus system for interprocess communication. | ||||||
| - **Daemon**: A background process that runs continuously to provide system services. | ||||||
|
|
||||||
| - **FISH (Friendly Interactive Shell)**: A user-friendly command-line shell with syntax highlighting, autosuggestions, and other advanced features. | ||||||
|
There was a problem hiding this comment. not sure if this is needed. multiple shells are mentioned (zsh, bash, fish) |
||||||
| - **FQDN (Fully Qualified Domain Name)**: A complete domain name that specifies the exact location of a device within the DNS hierarchy. | ||||||
|
|
||||||
| - **getcert**: A command-line tool used to request, monitor, and renew security certificates, often used with certmonger. | ||||||
| - **GSettings**: A system for storing application and desktop settings in GNOME-based environments. | ||||||
| - **GVfs (GNOME Virtual File System)**: A user-space virtual filesystem that provides access to remote locations, such as FTP, SMB, and Google Drive. | ||||||
|
|
||||||
| - **kernel**: The core of an operating system that manages hardware and system resources. | ||||||
|
There was a problem hiding this comment. probably not needed -- general concept. only mentioned twice. |
||||||
| - **Kerberos**: A network authentication protocol that uses tickets to securely authenticate users and services. | ||||||
|
|
||||||
| - **LDAP (Lightweight Directory Access Protocol)**: A protocol for accessing and managing directory information, commonly used for authentication. | ||||||
|
|
||||||
| - **Mount Managers**: Tools or processes that handle the mounting and unmounting of filesystems on Linux. | ||||||
| - **mounts**: The process of attaching a filesystem to a specific directory in the Linux file hierarchy. | ||||||
|
|
||||||
| - **PAM (Pluggable Authentication Modules)**: A framework for integrating various authentication methods into Linux systems. | ||||||
| - [**Polkit**](https://manpages.ubuntu.com/manpages/focal/man8/polkit.8.html): A toolkit for defining and handling system-wide privileges in Linux. | ||||||
| - **proxy**: A server or service that acts as an intermediary for network requests, often used for filtering or caching. | ||||||
|
|
||||||
| - **realmd**: A service that allows automatic discovery and enrollment of Linux machines into Active Directory or other identity domains. | ||||||
|
|
||||||
| - **Samba**: A software suite that enables file and print sharing between Linux and Windows systems using the SMB/CIFS protocol. | ||||||
| - **Security Identifier (SID)**: A unique identifier assigned to users, groups, and other objects in Windows-based systems. | ||||||
| - **SSSD (System Security Services Daemon)**: A service that manages authentication and authorization with identity providers like Active Directory or LDAP. | ||||||
|
There was a problem hiding this comment. for something like this you could mention that ADSys works with SSSD and provide a link to an explanation: https://documentation.ubuntu.com/adsys/en/stable/explanation/adsys-ref-arch/ |
||||||
| - **sudo**: A command that allows users to run programs with elevated (superuser) privileges. | ||||||
| - **systemd**: A modern system and service manager for Linux, responsible for initializing and managing system processes. | ||||||
| - **systemd journal**: A logging system that collects and organizes system logs for troubleshooting and auditing. | ||||||
|
|
||||||
| - **Ubiquity installer**: The default graphical installer for Ubuntu, designed to simplify OS installation. | ||||||
|
|
||||||
| - **visudo**: A command used to safely edit the sudoers file, which controls user permissions for executing commands with elevated privileges. | ||||||
|
|
||||||
| - **Winbind**: A component of Samba that allows Linux systems to authenticate users against a Windows domain. | ||||||
|
There was a problem hiding this comment. could say that this can be used instead of SSSD for authentication. |
||||||
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe some other ones to consider adding:
Could perhaps add an entry for server and client, just explaining that with respect to ADSys the serve is Windows Server and the clients are Ubuntu desktops and servers.
this glossary will be implemented in myst, and the syntax is:
definition:
:::{glossary}
MyST
: An amazing markup language that supports glossaries
:::
reference:
see: https://mystmd.org/guide/glossaries-and-terms