[pull] master from docker:master

.docker/Dockerfile.devenv

@@ -0,0 +1,3 @@
+FROM docker/dev-environments-ruby:stable-1
+RUN gem install bundler jekyll
+CMD ["bundle", "install"]

.docker/config.json

@@ -0,0 +1,3 @@
+{
+    "dockerfile": "Dockerfile.devenv"
+}

.dockerignore

@@ -1,7 +1,15 @@
-.dockerignore
+.DS_Store
 .git
+.github
 .gitignore
+.idea
+.jekyll-cache
+.jekyll-metadata
+.sass-cache
+tests
+_releaser
+_site
+CONTRIBUTING.md
 Dockerfile
 docker-compose.yml
-_site
-Gemfile.lock
+/vendor

.editorconfig

@@ -0,0 +1,5 @@
+root = true
+
+[*.{scss,html,md}]
+indent_style = space
+indent_size = 2

.env

@@ -0,0 +1,2 @@
+COMPOSE_DOCKER_CLI_BUILD=1
+DOCKER_BUILDKIT=1

.gitattributes

@@ -0,0 +1,2 @@
+# Auto-detect text files, ensure they use LF.
+* text=auto eol=lf

.github/CODEOWNERS

@@ -0,0 +1,22 @@
+# Each line is a file pattern followed by one or more owners.
+# Owners will be requested for review when someone opens a pull request.
+
+# For more details, see https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
+
+/build/ @crazy-max @usha-mandya @jedevc @dvdksn
+
+/compose/ @usha-mandya @aevesdocker
+
+/desktop/ @aevesdocker
+
+/docker-hub/ @jerae-duffin @craig-osterhout
+
+/engine/ @usha-mandya
+
+/subscription/ @jerae-duffin
+
+/docker-hub/publish/ @dvdksn
+
+/docker-hub/official_images/ @dvdksn
+
+/registry/ @dvdksn

.github/ISSUE_TEMPLATE.md

@@ -1,27 +1,41 @@
+
+<!--
+
+## READ ME FIRST
+
+This repository is for reporting issues related to Docker Documentation. Before submitting a new issue, check whether the issue has already been reported. You can join the discussion using an emoji, or by adding a comment to an existing issue.
+
+You can ask general questions and get community support through the Docker Community Forums - https://forums.docker.com/ and Slack - http://dockr.ly/slack. Personalized support is available through the Docker Pro, Team, and Business subscriptions. See https://www.docker.com/pricing for details.
+
+-->
+
 ### Problem description
 
-<!--Briefly describe the problem that you found.
-    Only DOCUMENTATION issues should be filed here.
-    For general questions, go to https://forums.docker.com/. -->
+<!--
+Briefly describe the problem that you found. A clear title and description helps us understand and address the issue quickly.
+
+Report only documentation issues here. Report any product issues in the corresponding product repository.
+
+If you are reporting a broken link issue, let us know how you arrived at the broken link; was it through a page on docs.docker.com, or from an external website?
+-->
 
 ### Problem location
 
-<!-- Help us find the problem quickly by choosing one of these. -->
+<!-- Help us find the problem quickly by choosing one of the following options: -->
 
-- I saw a problem on the following URL: <URL>
+- I saw a problem at the following URL: <Add URL>
 
-- I couldn't find the information I wanted. I expected to find it near the following URL: <URL>
+- I couldn't find the information I wanted. I expected to find it near the following URL <Add the URL and briefly describe how we can improve the existing content>
 
-- Other: <DETAILS>
+- Other: <Add details that can help us understand the issue>
 
 ### Project version(s) affected
 
 <!-- If this problem only affects specific versions of a project (like Docker
-     Engine 1.13), tell us here. The fix may need to take that into account. -->
+     Engine 20.10, or Docker Desktop 4.2.0), tell us here. The fix may need to take that into account. -->
 
 ### Suggestions for a fix
 
-<!--If you have specific ideas about how we can fix this, let us know. -->
-
+<!--If you have specific ideas about how we can fix this issue, let us know. -->
 
 <!-- To improve this template, edit the .github/ISSUE_TEMPLATE.md file -->

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,24 +1,9 @@
-<!--Thanks for your contribution. See [CONTRIBUTING](CONTRIBUTING.md)
-    for this project's contribution guidelines. Remove these comments
-    as you go.
-
-    DO NOT edit files and directories listed in _data/not_edited_here.yaml.
-    These are maintained in upstream repos and changes here will be lost.
-
-    Help us merge your changes more quickly by adding details and setting metadata
-    (such as labels, milestones, and reviewers) over at the right-hand side.-->
+<!--We’d like to make it as easy as possible for you to contribute to the Docker documentation repository. Before you submit the pull request, we recommend that you review the [Contribution guidelines](/contribute/overview.md). Remove these comments as you go.-->
 
 ### Proposed changes
 
 <!--Tell us what you did and why-->
 
-### Unreleased project version (optional)
-
-<!--If this change only applies to an unreleased version of a project, note
-    that here and base your work on the `vnext-` branch for your project. If
-    this doesn't apply to this PR, you can remove this whole section.
-    Set a milestone if appropriate. -->
-
 ### Related issues (optional)
 
 <!--Refer to related PRs or issues: #1234, or 'Fixes #1234' or 'Closes #1234'.

.github/vale/Docker/Acronyms.yml

@@ -0,0 +1,65 @@
+extends: conditional
+message: "'%s' has no definition."
+link: https://docs.docker.com/contribute/style/grammar/#acronyms-and-initialisms
+level: warning
+ignorecase: false
+# Ensures that the existence of 'first' implies the existence of 'second'.
+first: '\b([A-Z]{3,5})\b'
+second: '(?:\b[A-Z][a-z]+ )+\(([A-Z]{3,5})\)'
+# ... with the exception of these:
+exceptions:
+  - API
+  - ASP
+  - CLI
+  - CPU
+  - CSS
+  - CSV
+  - DEBUG
+  - DOM
+  - DPI
+  - FAQ
+  - GCC
+  - GDB
+  - GET
+  - GPU
+  - GTK
+  - GUI
+  - HEAD
+  - HTML
+  - HTTP
+  - HTTPS
+  - IDE
+  - JAR
+  - JSON
+  - JSX
+  - LESS
+  - LLDB
+  - NET
+  - NOTE
+  - NVDA
+  - OSS
+  - PATH
+  - PDF
+  - PHP
+  - POST
+  - RAM
+  - REPL
+  - RSA
+  - SCM
+  - SCSS
+  - SDK
+  - SQL
+  - SSH
+  - SSL
+  - SVG
+  - TBD
+  - TCP
+  - TODO
+  - URI
+  - URL
+  - USB
+  - UTF
+  - XML
+  - XSS
+  - YAML
+  - ZIP