devpro · devpro · Apr 20, 2026 · Mar 29, 2026 · Mar 30, 2026 · Mar 30, 2026
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -9,14 +9,17 @@ on:
       - main
   workflow_dispatch: {}
 
+permissions:
+  contents: read
+
 concurrency:
   group: "${{ github.ref }}-ci"
   cancel-in-progress: true
 
 jobs:
   markup-lint:
     name: Markup
-    uses: devpro/github-workflow-parts/.github/workflows/reusable-markup-lint.yml@c90ba46a93ca90123f57744b47e49c1a73962cea
+    uses: devpro/github-workflow-parts/.github/workflows/reusable-markup-lint.yml@fcf685247a8fa35a4330f3bbc9c328f13fec7e73
 
   code-quality:
     name: Code / Quality

diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
@@ -6,6 +6,13 @@ on:
       - main
   workflow_dispatch: {}
 
+permissions:
+  contents: read
+
+concurrency:
+  group: "${{ github.ref }}-deploy"
+  cancel-in-progress: false
+
 jobs:
   build:
     name: Build website

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -64,3 +64,39 @@ Check Markdown files:
 ```bash
 docker run --rm -v "$(pwd)":/workdir davidanson/markdownlint-cli2 "**/*.md"
 ```
+
+## Admonitions
+
+See [docusaurus.io/docs/markdown-features](https://docusaurus.io/docs/markdown-features/admonitions).
+
+```md
+:::note
+
+Some **content** with _Markdown_ `syntax`. Check [this `api`](#).
+
+:::
+
+:::tip
+
+Some **content** with _Markdown_ `syntax`. Check [this `api`](#).
+
+:::
+
+:::info
+
+Some **content** with _Markdown_ `syntax`. Check [this `api`](#).
+
+:::
+
+:::warning
+
+Some **content** with _Markdown_ `syntax`. Check [this `api`](#).
+
+:::
+
+:::danger
+
+Some **content** with _Markdown_ `syntax`. Check [this `api`](#).
+
+:::
+```
diff --git a/docs/fundamentals/infrastructure/containers/container-orchestration.md b/docs/fundamentals/infrastructure/containers/container-orchestration.md
@@ -1,9 +1,9 @@
-# Container orchestration
+# Container orchestration
 
 ## Solutions
 
 - [HashiCorp Nomad](https://www.nomadproject.io/)
 - [Kubernetes](https://github.com/devpro/learn-kubernetes)
 - [Red Hat OpenShift](../../../organizations/companies/redhat/openshift.md)
 
-<!-- Previously: Apache Mesos, Docker Swarm -->
+[//]: <> (Previously: Apache Mesos, Docker Swarm)
diff --git a/docs/fundamentals/infrastructure/operating-systems/linux-commands.md b/docs/fundamentals/infrastructure/operating-systems/linux-commands.md
@@ -1,12 +1,12 @@
-# Linux terminal
+# Linux terminal
 
 ## Additional packages
 
 Name     | Details
 ---------|---------------------------------------------------------------------------------------------------------------------------------
 **wget** | GNU Wget is a free software package for retrieving files using HTTP, HTTPS, FTP and FTPS the most widely-used Internet protocols
 
-<!-- TODO: difference between cat/less/more -->
+[//]: <> (difference between cat/less/more)
 
 ## Shortcuts
 

diff --git a/docs/fundamentals/standards/glossary.md b/docs/fundamentals/standards/glossary.md
@@ -1,31 +1,61 @@
 # Glossary
 
+## Business
+
+Acronym | Meaning
+--------|----------------------------
+ARR     | Annual Recurring Revenue
+GTM     | Go-To-Market
+ISV     | Independent Software Vendor
+MSP     | Managed Service Provider
+NRR     | Net Revenue Retention
+OKR     | Objectives and Key Results
+SA      | Solutions Architect
+TAM     | Technical Account Manager
+
 ## IT
 
 Acronym | Meaning
---------|--------------------------------------------------------------
+--------|----------------------------------------------------------------------------------
 BGP     | Border Gateway Protocol
+BYON    | Bring Your Own Network
+CD      | Continuous Delivery
+CI      | Continuous Integration
+CSP     | Cloud Service Provider
+DAST    | Dynamic Application Security Testing
+DFA     | Data flow analysis (a method used to understand how data moves through a program)
 DKIM    | Domain Keys Identified Mail
 DMARC   | Domain-based Message Authentication Reporting and Conformance
+HCI     | Hyperconverged Infrastructure
 FOSS    | Free and open source software
+PSA     | Professional Services Automation
+RPS     | Request Per Second
+SAST    | Static Application Security Testing
+SBOM    | Software Bill Of Materials
+SCA     | Software Composition Analysis
+SCM     | Source Code Management
+SDLC    | Software Development Lifecycle
 SRE     | Site Reliability Engineering
 SPF     | Sender Policy Framework
-
-## Programming
-
-Acronym | Meaning            | Details
---------|--------------------|-------------------------------------------------------------
-DFA     | Data flow analysis | A method used to understand how data moves through a program
+SSoT    | Single Source of Truth
+SOP     | Standard Operating Procedure
+VCS     | Version Control System
+VPC     | Virtual Private Cloud
 
 ## Security
 
 Acronym | Meaning
---------|---------------------------
+--------|---------------------------------------------
+ASPM    | Application Security Posture Management
+CDR     | Cloud Detection & Response
 CIEM    | Cloud Infrastructure Entitlement Management
 CNAPP   | Cloud Native Application Protection Platform
 CSPM    | Cloud Security Posture Management
+CTF     | Capture The Flag
 CWP     | Cloud Workload Protection
+CWPP    | Cloud Workload Protection Platform
 DSPM    | Data Security Posture Management
 KSPM    | Kubernetes Security Posture Management
 NHI     | Non-Human Identity
+SBOM    | Software Bill of Materials
 SOC     | Security Operations Center
diff --git a/docs/guides/workstations/windows/windows.md b/docs/guides/workstations/windows/windows.md
@@ -46,6 +46,13 @@ For previous versions: [Windows 10](archive/windows-10.md).
 
 1. [Visual Studio Code](../../../organizations/companies/microsoft/vscode.md)
 2. Git
+
+    Update git
+
+    ```cmd
+    git update-git-for-windows
+    ```
+
 3. Notepad++
 4. [MongoDB Compass](../../../organizations/companies/mongodb/compass.md)
 5. [Rider](../../../organizations/companies/jetbrains/rider.md) or [Visual Studio 2026](../../../organizations/companies/microsoft/vs2026.md)

diff --git a/docs/organizations/communities/go/go-file-organization.md b/docs/organizations/communities/go/go-file-organization.md
@@ -1,8 +1,8 @@
-# File organization in a Go project
+# File organization in a Go project
 
 🌐 [golang-standards/project-layout](https://github.com/golang-standards/project-layout)
 
-<!-- https://github.com/Avksenchik/golang-project-template -->
+See also [Avksenchik/golang-project-template](https://github.com/Avksenchik/golang-project-template)
 
 ## General view
 

diff --git a/...izations/companies/amazon/aws/glossary.md → ...ions/companies/amazon/aws/aws-glossary.md b/...izations/companies/amazon/aws/glossary.md → ...ions/companies/amazon/aws/aws-glossary.md
@@ -1,4 +1,4 @@
-# AWS glossary
+# AWS glossary
 
 🌐 [docs](https://docs.aws.amazon.com/glossary/latest/reference/glos-chap.html)
 
@@ -10,27 +10,30 @@ ACE  | APN Customer Engagements
 APN  | AWS Partner Network
 GSI  | Global System Integrator
 GSP  | Global Startup Program
-GTM  | Go-To-Market
-ISV  | Independent Software Vendor
-MSP  | Managed Service Provider
 PDM  | Partner Development Manager
 PSA  | Partner Solutions Architect
 RME  | Reliability Maintenance Engineering
-SA   | Solutions Architect
 SBI  | Situation, Behavior, Impact
-TAM  | Technical Account Manager
 
 ## Practices
 
-Name | Meaning                         | Links
------|---------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------
-CAF  | Cloud Adoption Framework        | [aws.amazon.com](https://aws.amazon.com/cloud-adoption-framework/)
-EBA  | Experience-Based Acceleration   | [aws.amazon.com/blogs](https://aws.amazon.com/blogs/mt/level-up-your-cloud-transformation-with-experience-based-acceleration-eba/)
-MAP  | Migration Acceleration Program  | [aws.amazon.com](https://aws.amazon.com/migration-acceleration-program/)
-MRA  | Migration Readiness Assessment  | -
-MRP  | Migration Readiness & Planning  | -
-ORR  | Operational Readiness Reviews   | [docs.aws.amazon.com/wellarchitected](https://docs.aws.amazon.com/wellarchitected/latest/operational-readiness-reviews/wa-operational-readiness-reviews.html)
-SRA  | Security Reference Architecture | [docs.aws.amazon.com/prescriptive-guidance](https://docs.aws.amazon.com/prescriptive-guidance/latest/security-reference-architecture/welcome.html)
+Name | Meaning
+-----|--------------------------------
+CAF  | Cloud Adoption Framework
+EBA  | Experience-Based Acceleration
+MAP  | Migration Acceleration Program
+MRA  | Migration Readiness Assessment
+MRP  | Migration Readiness & Planning
+ORR  | Operational Readiness Reviews
+SRA  | Security Reference Architecture
+
+Links:
+
+- [AWS Cloud Adoption Framework (AWS CAF)](https://aws.amazon.com/cloud-adoption-framework/)
+- [Level up your Cloud Transformation with Experience-Based Acceleration (EBA)](https://aws.amazon.com/blogs/mt/level-up-your-cloud-transformation-with-experience-based-acceleration-eba/)
+- [AWS Migration Acceleration Program](https://aws.amazon.com/migration-acceleration-program/)
+- [Operational Readiness Reviews (ORR)](https://docs.aws.amazon.com/wellarchitected/latest/operational-readiness-reviews/wa-operational-readiness-reviews.html)
+- [AWS Security Reference Architecture (AWS SRA) – core architecture](https://docs.aws.amazon.com/prescriptive-guidance/latest/security-reference-architecture/welcome.html)
 
 ## Technologies
 

diff --git a/docs/organizations/companies/amazon/aws/aws.md b/docs/organizations/companies/amazon/aws/aws.md
@@ -1,4 +1,4 @@
-# AWS
+# AWS
 
 > Amazon Web Services is the world’s most comprehensive and broadly adopted cloud, enabling customers to build anything they can imagine
 
@@ -8,7 +8,7 @@
 
 * [Architecture](architecture.md)
 * [Events](events.md)
-* [Glossary](glossary.md)
+* [Glossary](aws-glossary.md)
 * Localization: [EN](local-en.md), [FR](local-fr.md)
 * [Partners](partners.md)
 * [Products](products.md)

diff --git a/docs/organizations/companies/companies.md b/docs/organizations/companies/companies.md
@@ -1,4 +1,4 @@
-# Companies
+# Companies
 
 ## Software vendors & services
 
@@ -100,7 +100,7 @@ Name                                                | Country
 [Scaleway](https://www.scaleway.com/)               | France
 [UpCloud](https://upcloud.com/)                     | Finland
 
-<!-- [eucloud.tech](https://www.eucloud.tech/eu-providers/cloud) -->
+See also [eucloud.tech](https://www.eucloud.tech/eu-providers/cloud).
 
 ## Gaming industry
 

diff --git a/docs/organizations/companies/docker/docker-engine.md b/docs/organizations/companies/docker/docker-engine.md
@@ -1,4 +1,4 @@
-# Docker engine
+# Docker engine
 
 > Docker Engine (also known as Docker CE) is an open source containerization technology for building and containerizing your applications
 
@@ -16,13 +16,16 @@ sudo apt-get install ca-certificates curl
 sudo install -m 0755 -d /etc/apt/keyrings
 sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
 sudo chmod a+r /etc/apt/keyrings/docker.asc
-echo \
-  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
-  $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
-  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
+sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
+Types: deb
+URIs: https://download.docker.com/linux/ubuntu
+Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
+Components: stable
+Architectures: $(dpkg --print-architecture)
+Signed-By: /etc/apt/keyrings/docker.asc
+EOF
 sudo apt-get update
 sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
-sudo docker run hello-world
 sudo usermod -aG docker $USER
 newgrp docker
 docker --version

diff --git a/docs/organizations/companies/dynatrace/dynatrace-glossary.md b/docs/organizations/companies/dynatrace/dynatrace-glossary.md
@@ -0,0 +1,6 @@
+# Dynatrace Glossary
+
+Acronym | Meaning
+--------|--------------------------------
+ACE     | Autonomous Cloud Enablement
+DPS     | Dynatrace Platform Subscription
diff --git a/docs/organizations/companies/dynatrace/dynatrace.md b/docs/organizations/companies/dynatrace/dynatrace.md
@@ -1,10 +1,10 @@
-# Dynatrace
+# Dynatrace
 
 🌐 [dynatrace.com](https://www.dynatrace.com/)
 
 ## Content
 
-* [Glossary](glossary.md)
+* [Glossary](dynatrace-glossary.md)
 * [Licensing](licensing.md)
 * [OpenTelemetry](opentelemetry.md)
 * [Professional Services](professional-services.md)

diff --git a/docs/organizations/companies/dynatrace/glossary.md b/docs/organizations/companies/dynatrace/glossary.md
diff --git a/docs/organizations/companies/gitlab/gitlab-glossary.md b/docs/organizations/companies/gitlab/gitlab-glossary.md
@@ -0,0 +1,22 @@
+# Glossary for GitLab
+
+Acronym | Meaning
+--------|----------------------------------------------------------------------------------------
+CE      | Community Edition
+EE      | Enterprise Edition
+GDK     | GitLab Development Kit
+GET     | GitLab Environment Toolkit
+GKMS    | Google Cloud Platform Key Management Service
+GLFM    | GitLab Flavored Markdown ([docs/user/markdown](https://docs.gitlab.com/user/markdown/))
+MR      | Merge Request
+PS      | Professional Services
+PSE     | Professional Services Engineer
+
+References:
+
+* [Geo glossary](https://docs.gitlab.com/administration/geo/glossary/)
+* [Licensing & Renewals Glossary of Terms](https://handbook.gitlab.com/handbook/support/license-and-renewals/license-and-renewals-glossary/)
+* [Remote Work Glossary](https://handbook.gitlab.com/handbook/company/culture/all-remote/remote-work-glossary/)
+* [Security glossary](https://docs.gitlab.com/user/application_security/terminology/index/)
+* [Support Glossary](https://handbook.gitlab.com/handbook/support/support-idk/)
+* [GitLab Secrets Manager ADR 002](https://handbook.gitlab.com/handbook/engineering/architecture/design-documents/secret_manager/decisions/002_gcp_kms/)
diff --git a/docs/organizations/companies/gitlab/gitlab.md b/docs/organizations/companies/gitlab/gitlab.md
@@ -1,4 +1,4 @@
-# GitLab
+# GitLab
 
 > GitLab is the most comprehensive AI-powered DevSecOps Platform
 
@@ -28,7 +28,7 @@ GitLab is a company that provides an [Application Lifecycle Management (ALM)](al
 * 🌟 [GitLab Blog](https://about.gitlab.com/blog/)
 * [GitLab Certifications](https://university.gitlab.com/pages/certifications)
 * 🌟 [GitLab Documentation](https://docs.gitlab.com/)
-* [GitLab Glossary](glossary.md)
+* [GitLab Glossary](gitlab-glossary.md)
 * 🌟 [GitLab Handbook](handbook.md)
 * [GitLab Resources](resources.md)
 * [GitLab University](university.md)