Glossary definitions use direct evergreen prose

docs/content/Dictionary/api.md

@@ -6,6 +6,6 @@ abbreviations:
 
 # Application Programming Interface
 
-Application Programming Interface (API) - A set of protocols, routines, and tools for building software applications. APIs specify how software components should interact and are used when programming graphical user interface (GUI) components.
+An Application Programming Interface (API) is a set of rules for communication between software components.
 
-**Example**: The [GitHub](github.md) API allows developers to interact with GitHub repositories, issues, and pull requests programmatically.
+**Example**: Developers use the [GitHub](github.md) API to work with repositories, issues, and pull requests from scripts.

docs/content/Dictionary/azure-functions.md

@@ -5,4 +5,4 @@ abbreviations: []
 
 # Azure Functions
 
-A serverless compute service that lets you run event-triggered code without having to explicitly provision or manage infrastructure.
+Azure Functions runs code in response to events. Serverless hosting options manage the infrastructure that runs the code.

docs/content/Dictionary/branch.md

@@ -5,6 +5,6 @@ abbreviations: []
 
 # Branch
 
-In version control systems like [Git](git.md), a branch is a parallel version of a [repository](repository.md) that diverges from the main working project.
+In version control, a branch is an independent line of development. In [Git](git.md), it points to a commit in a [repository](repository.md).
 
-**Example**: Feature branches are used to develop new features in isolation before merging back to the main branch.
+**Example**: Feature branches keep work separate before developers merge it into the main branch.

docs/content/Dictionary/ci-cd.md

@@ -8,4 +8,8 @@ abbreviations:
 
 # Continuous Integration and Continuous Deployment
 
-Continuous Integration/Continuous Deployment (CI/CD) - A software development practice where developers regularly merge their code changes into a central repository, after which automated builds and tests are run.
+CI/CD combines Continuous Integration with Continuous Delivery or Continuous Deployment.
+
+Continuous Integration (CI) uses automated builds and tests when developers merge code changes into a shared repository.
+
+Continuous Delivery keeps tested changes ready for production deployment. Continuous Deployment automatically deploys each change that passes the pipeline to production.

docs/content/Dictionary/cmdlet.md

@@ -5,6 +5,6 @@ abbreviations: []
 
 # Cmdlet
 
-A lightweight [PowerShell](powershell.md) command that follows the verb-noun naming convention and is designed to perform a specific function.
+A cmdlet is a lightweight [PowerShell](powershell.md) command that performs a specific task and follows the verb-noun naming convention.
 
 **Example**: `Get-Process`, `Set-Location`, `New-Item`

docs/content/Dictionary/docker.md

@@ -5,4 +5,4 @@ abbreviations: []
 
 # Docker
 
-A platform for developing, shipping, and running applications using containerization technology.
+Docker is a platform with tools to develop, distribute, and run applications in containers.

docs/content/Dictionary/github-actions.md

@@ -6,6 +6,6 @@ abbreviations:
 
 # GitHub Actions
 
-[GitHub's](github.md) built-in [CI/CD](ci-cd.md) platform that allows you to automate your build, test, and deployment [pipeline](pipeline.md).
+GitHub Actions is [GitHub's](github.md) [CI/CD](ci-cd.md) platform. It automates build, test, and deployment tasks in a [pipeline](pipeline.md).
 
-**Example**: Automatically running tests when a [pull request](pull-request.md) is created.
+**Example**: A workflow runs tests when a contributor creates a [pull request](pull-request.md).

docs/content/Dictionary/github.md

@@ -7,4 +7,4 @@ abbreviations:
 
 # GitHub
 
-A web-based platform for version control and collaboration that lets you and others work together on projects from anywhere.
+GitHub is a web-based platform for version control and collaboration.

docs/content/Dictionary/index.md

@@ -1,8 +1,8 @@
 # Glossary
 
-Welcome to the PSModule Glossary, a reference of terms, concepts, and technologies used throughout our projects and documentation.
+This glossary is a reference for terms, concepts, and technologies in PSModule projects and documentation.
 
-## Table of Contents
+## Table of contents
 
 - [API](api.md)
 - [Azure](azure.md)
@@ -36,12 +36,13 @@ Welcome to the PSModule Glossary, a reference of terms, concepts, and technologi
 - [Workflow](workflow.md)
 - [YAML](yaml.md)
 
-## Quick Reference
+## Quick reference
+
+The quick reference lists common PSModule terms.
 
-Common terms you might encounter:
 - [API](api.md) - Application Programming Interface
 - [Azure](azure.md) - Microsoft's cloud platform
-- [CI/CD](ci-cd.md) - Continuous Integration/Continuous Deployment
+- [CI/CD](ci-cd.md) - Continuous Integration with Continuous Delivery or Continuous Deployment
 - [Cmdlet](cmdlet.md) - PowerShell command
 - [Git](git.md) - Version control system
 - [GitHub](github.md) - Code hosting platform
@@ -55,10 +56,10 @@ Common terms you might encounter:
 
 ## Overview
 
-This glossary serves as a reference for developers, contributors, and users to understand the terminology and concepts used in PSModule projects. Each entry includes clear definitions, usage examples, and related links where applicable.
+Each entry gives a definition. Some entries also include examples and links to related terms.
 
-!!! info "Contributing to the Glossary"
-    Found a term that should be added or need to update an existing definition? Please [create an issue](https://github.com/PSModule/Process-PSModule/issues) or submit a pull request with your suggestions.
+!!! info "Contributing to the glossary"
+    To add a term or correct a definition, [create an issue](https://github.com/PSModule/Process-PSModule/issues) or submit a pull request.
 
-!!! tip "Search Functionality"
-    Use the search feature in the top navigation to quickly find specific terms and their definitions across the entire documentation site.
+!!! tip "Search functionality"
+    Use the search field in the top navigation to find terms and definitions across the documentation site.

docs/content/Dictionary/lts.md

@@ -6,5 +6,6 @@ abbreviations:
 
 # Long-Term Servicing
 
-Long-Term Servicing (LTS).
-For more info visit: [PowerShell Support Lifecycle](https://learn.microsoft.com/en-us/powershell/scripting/install/powershell-support-lifecycle?view=powershell-7.5)
+PowerShell Long-Term Servicing (LTS) releases use .NET LTS releases.
+
+See [PowerShell Support Lifecycle](https://learn.microsoft.com/en-us/powershell/scripting/install/powershell-support-lifecycle?view=powershell-7.5) for support policies and end-of-support dates.

docs/content/Dictionary/markdown.md

@@ -5,4 +5,4 @@ abbreviations: []
 
 # Markdown
 
-A lightweight markup language with plain text formatting syntax, designed to be converted to HTML and many other formats.
+Markdown is a lightweight markup language that uses plain text syntax. Tools convert Markdown documents to HTML and other formats.

docs/content/Dictionary/mkdocs.md

@@ -6,4 +6,4 @@ abbreviations:
 
 # MkDocs
 
-A fast, simple static site generator that's geared towards building project documentation using [Markdown](markdown.md) files.
+MkDocs is a static site generator for project documentation. It builds sites from [Markdown](markdown.md) files.

docs/content/Dictionary/pipeline.md

@@ -5,4 +5,4 @@ abbreviations: []
 
 # Pipeline
 
-A series of automated processes that allow developers and [DevOps](devops.md) professionals to reliably and efficiently compile, build, and deploy their code.
+A pipeline is a series of automated processes that developers and [DevOps](devops.md) teams use to compile, build, and deploy code.

docs/content/Dictionary/powershell.md

@@ -5,4 +5,4 @@ abbreviations: []
 
 # PowerShell
 
-A task automation and configuration management framework from Microsoft, consisting of a command-line shell and the associated scripting language.
+PowerShell is a task automation and configuration management framework from Microsoft. It includes a command-line shell and a scripting language.

docs/content/Dictionary/pull-request.md

@@ -5,4 +5,4 @@ abbreviations: []
 
 # Pull Request
 
-Pull Request (PR) - A method of submitting contributions to a software project where changes are proposed and reviewed before being merged into the main codebase.
+A Pull Request (PR) proposes changes to a software project for review before a merge into the codebase.

docs/content/Dictionary/rest-api.md

@@ -8,4 +8,6 @@ abbreviations:
 
 # Representational State Transfer API
 
-An architectural style for designing web services that uses HTTP requests to GET, PUT, POST, and DELETE data.
+A REST API is an interface for a web service that follows the Representational State Transfer (REST) architectural style.
+
+Clients use HTTP methods such as `GET`, `PUT`, `POST`, and `DELETE` to work with resources.

docs/content/Dictionary/semantic-versioning.md

@@ -5,6 +5,6 @@ abbreviations: []
 
 # Semantic Versioning
 
-Semantic Versioning (SemVer) - A versioning scheme that uses a three-part version number: MAJOR.MINOR.PATCH, where each part is incremented based on the type of changes made.
+Semantic Versioning (SemVer) uses the three-part version format `MAJOR.MINOR.PATCH`. The version number indicates whether a change affects compatibility, adds functionality, or fixes a bug.
 
 **Example**: Version 1.2.3 where 1 is major, 2 is minor, and 3 is patch.

docs/content/Dictionary/template.md

@@ -5,4 +5,4 @@ abbreviations: []
 
 # Template
 
-A pre-designed format or structure that can be used as a starting point for creating new files, projects, or configurations.
+A template gives a format or structure for new files, projects, or configurations.

docs/content/Dictionary/workflow.md

@@ -5,6 +5,6 @@ abbreviations: []
 
 # Workflow
 
-A series of automated steps or processes that execute in response to specific events or triggers.
+A workflow is an automated process that runs in response to an event or trigger.
 
-**Example**: A [GitHub Actions](github-actions.md) workflow that runs tests every time code is pushed to a [repository](repository.md).
+**Example**: A [GitHub Actions](github-actions.md) workflow runs tests each time a contributor pushes code to a [repository](repository.md).

docs/content/Dictionary/yaml.md

@@ -6,6 +6,6 @@ abbreviations:
 
 # YAML Ain't Markup Language
 
-YAML Ain't Markup Language (YAML) - A human-readable data serialization standard commonly used for configuration files and data exchange.
+YAML Ain't Markup Language (YAML) is a human-readable data serialization standard. Applications use YAML for configuration files and data exchange.
 
-**Example**: [GitHub Actions](github-actions.md) workflows are defined using YAML files.
+**Example**: [GitHub Actions](github-actions.md) workflows use YAML files.

docs/includes/abbreviations.md

@@ -3,13 +3,13 @@
 *[CD]: Continuous Deployment or Continuous Delivery
 *[CDN]: Content Delivery Network
 *[CI]: Continuous Integration
-*[CI/CD]: Continuous Integration/Continuous Deployment
+*[CI/CD]: Continuous Integration with Continuous Delivery or Continuous Deployment
 *[CLI]: Command Line Interface
 *[CRUD]: Create, Read, Update, Delete
 *[CSS]: Cascading Style Sheets
 *[DevOps]: Development and Operations
 *[DNS]: Domain Name System
-*[Docker]: Platform for developing, shipping, and running applications in containers
+*[Docker]: Platform with tools to develop, distribute, and run applications in containers
 *[GH]: GitHub
 *[GHE]: GitHub Enterprise
 *[GHEC]: GitHub Enterprise Cloud
@@ -19,7 +19,7 @@
 *[Git]: Version Control System
 *[GitHub]: Web-based platform for version control using Git
 *[GitLab]: Web-based DevOps lifecycle tool that provides a Git repository manager
-*[HTML]: Hyper Text Markup Language
+*[HTML]: HyperText Markup Language
 *[HTTP]: Hypertext Transfer Protocol
 *[HTTPS]: Hypertext Transfer Protocol Secure
 *[IaaS]: Infrastructure as a Service
@@ -35,7 +35,7 @@
 *[ps1xml]: PowerShell XML File
 *[psd1]: PowerShell Data File
 *[psm1]: PowerShell Module File
-*[pwsh]: PowerShell Core (also known as PowerShell 7)
+*[pwsh]: PowerShell 7 command-line executable
 *[REST]: Representational State Transfer
 *[SaaS]: Software as a Service
 *[SEO]: Search Engine Optimization
@@ -47,4 +47,4 @@
 *[UX]: User Experience
 *[VPN]: Virtual Private Network
 *[W3C]: World Wide Web Consortium
-*[XML]: eXtensible Markup Language
+*[XML]: Extensible Markup Language