Merge branch 'main' into ENGDOCS-2862-reqs-and-responses

Author: ArthurFlag

.github/prompts/freshness-tier1.prompt.md

@@ -12,5 +12,6 @@ how fresh and up to date it is. Apply the following:
 5. Ensure all the components formatted correctly.
 6. Improve the SEO keywords.
 7. If you find numbered lists, make sure their numbering only uses 1's.
+8. Ensure each line is limited to 80 characters.
 
 Do your best and don't be lazy.

.github/prompts/freshness-tier2.prompt.md

@@ -18,5 +18,6 @@ how fresh and up to date it is. Apply the following:
 5. Try to add some helpful next steps to the end of the document, but only if there are no *Next steps* or *Related pages* section, already.
 6. Try to clarify, shorten or improve the efficiency of some sentences.
 7. Check for LLM readibility.
+8. Ensure each line is limited to 80 characters.
 
 Do your best and don't be lazy.

.github/workflows/validate-upstream.yml

@@ -39,7 +39,7 @@ jobs:
           repository: docker/docs
       -
         name: Download data files
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v5
         if: ${{ inputs.data-files-id != '' && inputs.data-files-folder != '' }}
         with:
           name: ${{ inputs.data-files-id }}

.vale.ini

@@ -1,8 +1,31 @@
 StylesPath = _vale
 MinAlertLevel = suggestion
-
+IgnoredScopes = text.frontmatter, code, tt, b, strong, i, a
 Vocab = Docker
 
+# Disable rules for genered content
+[content/reference/**/**.md]
+Vale.Spelling = NO
+Vale.Terms = NO
+Docker.Capitalization = NO
+
+[content/manuals/*/release-notes/*.md]
+Vale.Spelling = NO
+Vale.Terms = NO
+Docker.Capitalization = NO
+
+[content/contribute/*.md]
+Vale.Spelling = NO
+Vale.Terms = NO
+Docker.Capitalization = NO
+Docker.Exclamation = NO
+
+[content/manuals/desktop/previous-versions/*.md]
+Vale.Spelling = NO
+Vale.Terms = NO
+Docker.Capitalization = NO
+Docker.Exclamation = NO
+
 [*.md]
 BasedOnStyles = Vale, Docker
 # Exclude `{{< ... >}}`, `{{% ... %}}`, [Who]({{< ... >}})
@@ -15,10 +38,3 @@ TokenIgnores = ({{[%<] .* [%>]}}.*?{{[%<] ?/.* [%>]}}), \
 # Exclude `{{< myshortcode `This is some <b>HTML</b>, ... >}}`
 BlockIgnores = (?sm)^({{[%<] \w+ [^{]*?\s[%>]}})\n$, \
 (?s) *({{< highlight [^>]* ?>}}.*?{{< ?/ ?highlight >}})
-
-# Disable rules for genered content
-# Content is checked upstream
-[**/{model-cli/docs/reference,content/reference/cli/docker/model}/**.md]
-BasedOnStyles = Vale
-Vale.Spelling = NO
-Vale.Terms = NO

README.md

@@ -2,19 +2,17 @@
 
 <img src="static/assets/images/docker-docs.png" alt="Welcome to Docker Documentation" style="max-width: 45%;">
 
-Welcome to the Docker Documentation repository. This is the source for
-[https://docs.docker.com/](https://docs.docker.com/).
+Welcome to the Docker Documentation repository. This is the source for the [Docker Docs Website](https://docs.docker.com/).
 
-Feel free to send us pull requests and issues. Our docs are completely
-open source, and we deeply appreciate contributions from the Docker community!
+We welcome your contributions—feel free to open pull requests or issues. Our docs are completely open source, and we deeply appreciate contributions from the Docker community!
 
 ## Provide feedback
 
 We’d love to hear your feedback! To submit feedback:
 - Click **[New issue](https://github.com/docker/docs/issues/new)** on the docs repository, or
 - Click **Request changes** in the right column of every page on
   [docs.docker.com](https://docs.docker.com/), or
-- Click **Give feedback** on of every page in the docs.
+- Click **Give feedback** on every page in the docs.
 
 To get community support, use the [Docker Community Slack](https://dockr.ly/comm-slack). Personalized support is available
 through the Docker Pro, Team, and Business subscriptions. See [Docker
@@ -30,4 +28,4 @@ See [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## Copyright and license
 
-Copyright 2013-2025 Docker, Inc., released under the <a href="https://github.com/docker/docs/blob/main/LICENSE">Apache 2.0 license</a> .
+Copyright 2013-2025 Docker, Inc., released under the [Apache 2.0 license](https://github.com/docker/docs/blob/main/LICENSE).

_vale/config/vocabularies/Docker/accept.txt

@@ -1,13 +1,17 @@
 (?i)[A-Z]{2,}'?s
+
 Adreno
 Aleksandrov
 Amazon
 Anchore
 Apple
 Artifactory
+auditable
+autolock
 Azure
 bootup
 Btrfs
+Bugsnag
 BuildKit
 BusyBox
 CentOS
@@ -16,6 +20,8 @@ cgroup
 Chrome
 Chrome DevTools
 Citrix
+cli
+CLI
 CloudFront
 Codefresh
 Codespaces
@@ -27,6 +33,7 @@ datacenter
 Datadog
 Ddosify
 Debootstrap
+denylist
 deprovisioning
 deserialization
 deserialize
@@ -53,7 +60,9 @@ Dockerize
 Dockerizing
 Entra
 EPERM
+ESXi
 Ethernet
+exploitability
 Fargate
 Fedora
 firewalld
@@ -63,24 +72,29 @@ g?libc
 GeoNetwork
 GGUF
 Git
-GitHub( Actions)?
+GitHub
+GitHub Actions
 Google
 Grafana
 Gravatar
 gRPC
+Grype
 HyperKit
 inferencing
 inotify
 Intel
 Intune
+IPsec
 iptables
 IPv[46]
 IPvlan
 isort
 Jamf
+JavaScript
 JetBrains
 JFrog
 JUnit
+Kata
 Kerberos
 Kitematic
 Kubeadm
@@ -93,6 +107,7 @@ Laravel
 libseccomp
 Linux
 LinuxKit
+Loggly
 Logstash
 lookup
 Mac
@@ -106,10 +121,11 @@ monorepos?
 musl
 MySQL
 nameserver
-namespace
+namespaced?
 namespacing
 netfilter
 netlabel
+netlink
 Netplan
 NFSv\d
 Nginx
@@ -130,21 +146,27 @@ Postgres
 PowerShell
 Python
 Qualcomm
+Quickview
+rebalance
+reimplement
 rollback
 rootful
 runc
 Ryuk
 S3
 scrollable
+SELinux
 Slack
 snapshotters?
 Snyk
 Solr
 SonarQube
+Splunk
 SQLite
 stdin
 stdout
 subfolder
+subvolume
 Syft
 syntaxes
 Sysbox
@@ -154,22 +176,30 @@ systemd
 Testcontainers
 tmpfs
 Traefik
+Trivy
 Trixie
 Ubuntu
 ufw
+ui
 uid
 umask
+undeterminable
 Unix
 unmanaged
 VMware
 vpnkit
-vSphere
 VSCode
+vSphere
+Vue
 Wasm
+Wasmtime
 Windows
 windowsfilter
 WireMock
+workdir
 Xdebug
+youki
+Yubikey
 Zscaler
 Zsh
 [Aa]nonymized?