From 8a38e443b2821a21fcf84679ee2fb7a99911725d Mon Sep 17 00:00:00 2001
From: HonkingGoose <34918129+HonkingGoose@users.noreply.github.com>
Date: Mon, 18 Jan 2021 18:30:30 +0100
Subject: [PATCH] docs: improve docker usage documentation (#8334)

---
 docs/usage/docker.md | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/docs/usage/docker.md b/docs/usage/docker.md
index 2ade7bf3c7..c4f4cbf56d 100644
--- a/docs/usage/docker.md
+++ b/docs/usage/docker.md
@@ -165,6 +165,11 @@ If you want Renovate to commit directly to your base branch without opening a PR
 
 ### Registry authentication
 
+There are many different registries, and many ways to authenticate to those registries.
+We will explain how to authenticate for the most common registries.
+
+#### DockerHub
+
 Here is an example of configuring a default Docker username/password in `config.js`.
 The Docker Hub password is stored in a process environment variable.
 
@@ -182,6 +187,8 @@ module.exports = {
 
 You can add additional host rules, read the [hostrules documentation](https://docs.renovatebot.com/configuration-options/#hostrules) for more information.
 
+#### Self-hosted Docker registry
+
 Say you host some Docker images yourself, and use a password to access your self-hosted Docker images.
 In addition to self-hosting, you also pull images from Docker Hub, without a password.
 In this example you would configure a specific Docker host like this:
@@ -199,7 +206,10 @@ module.exports = {
 };
 ```
 
-You might be hosting your own chartmuseum somewhere to manage your private Helm Charts. Here is how you would connect to a private Helm repository :
+#### ChartMuseum
+
+Maybe you're running your own ChartMuseum server to host your private Helm Charts.
+This is how you connect to a private Helm repository:
 
 ```js
 module.exports = {
-- 
GitLab