CI - added test for keywords in markdown frontmatters (#805)

* added test for keywords

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* fixed keywords in some md files for tests to pass

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* fixed keywords in /datacenter

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* tests/Dockerfile: no need to add git

Signed-off-by: Adrien Duermael <adrien@duermael.com>

* tests/Dockerfile: changed maintainer

Signed-off-by: Adrien Duermael <adrien@duermael.com>

datacenter/dtr/2.0/support.md

@@ -1,11 +1,9 @@
 ---
-redirect_from:
-- /docker-trusted-registry/support/
 description: Your Docker subscription gives you access to prioritized support. You
   can file tickets via email, your the support portal.
-keywords:
+keywords: Docker, support, help
-- Docker, support
+redirect_from:
-- help
+- /docker-trusted-registry/support/
 title: Get support for DTR
 ---
 

datacenter/dtr/2.1/guides/architecture.md

@@ -1,8 +1,7 @@
 ---
-title: DTR architecture
 description: Learn about the architecture of Docker Trusted Registry.
-keywords:
+keywords: docker, registry, dtr, architecture
-- docker, registry, dtr, architecture
+title: DTR architecture
 ---
 
 Docker Trusted Registry (DTR) is a Dockerized application that runs on a Docker

datacenter/dtr/2.1/guides/configure/configure-storage.md

@@ -1,8 +1,8 @@
 ---
-title: Configure where images are stored
 description: Storage configuration for Docker Trusted Registry
-keywords:
+keywords: docker, documentation, about, technology, understanding, configuration,
-- docker, documentation, about, technology, understanding, configuration, storage, storage drivers, Azure, S3, Swift,  enterprise, hub, registry
+  storage, storage drivers, Azure, S3, Swift, enterprise, hub, registry
+title: Configure where images are stored
 ---
 
 After installing Docker Trusted Registry, one of your first tasks is to

datacenter/dtr/2.1/guides/configure/index.md

@@ -1,8 +1,8 @@
 ---
-title: Use your own certificates
 description: Trusted Registry configuration options
-keywords:
+keywords: docker, documentation, about, technology, install, enterprise, hub, CS engine,
-- docker, documentation, about, technology, install, enterprise, hub, CS engine, Docker Trusted Registry, configure, storage, backend, drivers
+  Docker Trusted Registry, configure, storage, backend, drivers
+title: Use your own certificates
 ---
 
 By default the DTR services are exposed using HTTPS, to ensure all

datacenter/dtr/2.1/guides/high-availability/backups-and-disaster-recovery.md

@@ -1,9 +1,8 @@
 ---
-title: Backups and disaster recovery
 description: Learn how to backup your Docker Trusted Registry cluster, and to recover
   your cluster from an existing backup.
-keywords:
+keywords: docker, registry, high-availability, backup, recovery
-- docker, registry, high-availability, backup, recovery
+title: Backups and disaster recovery
 ---
 
 When you decide to start using Docker Trusted Registry on a production

datacenter/dtr/2.1/guides/high-availability/index.md

@@ -1,8 +1,7 @@
 ---
-title: Set up high availability
 description: Learn how to set up Docker Trusted Registry for high availability.
-keywords:
+keywords: docker, registry, high-availability, backup, recovery
-- docker, registry, high-availability, backup, recovery
+title: Set up high availability
 ---
 
 Docker Trusted Registry (DTR) is designed for high availability.

datacenter/dtr/2.1/guides/index.md

@@ -1,7 +1,6 @@
 ---
 description: Learn how to install, configure, and use Docker Trusted Registry.
-keywords:
+keywords: docker, registry, repository, images
-- docker, registry, repository, images
 title: Docker Trusted Registry overview
 ---
 

datacenter/dtr/2.1/guides/install/index.md

@@ -1,8 +1,7 @@
 ---
-title: Install Docker Trusted Registry
 description: Learn how to install Docker Trusted Registry for production.
-keywords:
+keywords: docker, dtr, registry, install
-- docker, dtr, registry, install
+title: Install Docker Trusted Registry
 ---
 
 Docker Trusted Registry (DTR) is a containerized application that runs on a

datacenter/dtr/2.1/guides/install/install-offline.md

@@ -1,9 +1,8 @@
 ---
-title: Install Docker Trusted Registry offline
 description: Learn how to install Docker Trusted Registry on a machine with no internet
   access.
-keywords:
+keywords: docker, registry, install, offline
-- docker, registry, install, offline
+title: Install Docker Trusted Registry offline
 ---
 
 The procedure to install Docker Trusted Registry on a node is the same,

datacenter/dtr/2.1/guides/install/license.md

@@ -1,8 +1,7 @@
 ---
-title: License Docker Trusted Registry
 description: Learn how to license your Docker Trusted Registry installation.
-keywords:
+keywords: docker, dtr, install, license
-- docker, dtr, install, license
+title: License Docker Trusted Registry
 ---
 
 By default, you don't need to license your Docker Trusted Registry. When

datacenter/dtr/2.1/guides/install/system-requirements.md

@@ -1,8 +1,7 @@
 ---
-title: Docker Trusted Registry system requirements
 description: Learn about the system requirements for installing Docker Trusted Registry.
-keywords:
+keywords: docker, DTR, architecture, requirements
-- docker, DTR, architecture, requirements
+title: Docker Trusted Registry system requirements
 ---
 
 Docker Trusted Registry can be installed on-premises or on the cloud.

datacenter/dtr/2.1/guides/install/uninstall.md

@@ -1,8 +1,7 @@
 ---
-title: Uninstall Docker Trusted Registry
 description: Learn how to uninstall your Docker Trusted Registry installation.
-keywords:
+keywords: docker, dtr, install, uninstall
-- docker, dtr, install, uninstall
+title: Uninstall Docker Trusted Registry
 ---
 
 Use the `remove` command, to remove a DTR replica from an existing deployment.

datacenter/dtr/2.1/guides/install/upgrade.md

@@ -1,8 +1,7 @@
 ---
-title: Upgrade DTR
 description: Learn how to upgrade your Docker Trusted Registry
-keywords:
+keywords: docker, dtr, upgrade, install
-- docker, dtr, upgrade, install
+title: Upgrade DTR
 ---
 
 The first step in upgrading to a new minor version or patch release of DTR 2.0,

datacenter/dtr/2.1/guides/monitor-troubleshoot/index.md

@@ -1,8 +1,7 @@
 ---
-title: Monitor Docker Trusted Registry
 description: Learn how to monitor your DTR installation.
-keywords:
+keywords: docker, registry, monitor, troubleshoot
-- docker, registry, monitor, troubleshoot
+title: Monitor Docker Trusted Registry
 ---
 
 Docker Trusted Registry is a Dockerized application. To monitor it, you can

datacenter/dtr/2.1/guides/monitor-troubleshoot/troubleshoot.md

@@ -1,8 +1,7 @@
 ---
-title: Troubleshoot Docker Trusted Registry
 description: Learn how to troubleshoot your DTR installation.
-keywords:
+keywords: docker, registry, monitor, troubleshoot
-- docker, registry, monitor, troubleshoot
+title: Troubleshoot Docker Trusted Registry
 ---
 
 High availability in DTR depends on having overlay networking working in UCP.

datacenter/dtr/2.1/guides/release-notes.md

@@ -1,11 +1,10 @@
 ---
-title: Docker Trusted Registry release notes
 description: Docker Trusted Registry release notes
-keywords:
+keywords: docker trusted registry, whats new, release notes
-- docker trusted registry, whats new, release notes
 redirect_from:
 - /docker-trusted-registry/release-notes/release-notes/
 - /docker-trusted-registry/release-notes/
+title: Docker Trusted Registry release notes
 ---
 
 Here you can learn about new features, bug fixes, breaking changes and

datacenter/dtr/2.1/guides/repos-and-images/delete-an-image.md

@@ -1,8 +1,7 @@
 ---
-title: Delete an image
 description: Learn how to delete images from your repositories on Docker Trusted Registry.
-keywords:
+keywords: docker, registry, repository, delete, image
-- docker, registry, repository, delete, image
+title: Delete an image
 ---
 
 To delete an image, go to the **DTR web UI**, and navigate to the image

datacenter/dtr/2.1/guides/repos-and-images/index.md

@@ -1,7 +1,7 @@
 ---
-description: Learn how to configure your Docker Engine to push and pull images from Docker Trusted Registry.
+description: Learn how to configure your Docker Engine to push and pull images from
-keywords:
+  Docker Trusted Registry.
-- docker, registry, TLS, certificates
+keywords: docker, registry, TLS, certificates
 title: Configure your Docker Engine
 ---
 

datacenter/dtr/2.1/guides/repos-and-images/pull-an-image.md

@@ -1,8 +1,7 @@
 ---
-title: Pull an image from DTR
 description: Learn how to pull an image from Docker Trusted Registry.
-keywords:
+keywords: docker, registry, images, pull
-- docker, registry, images, pull
+title: Pull an image from DTR
 ---
 
 Pulling an image from Docker Trusted Registry is the same as pulling an image

datacenter/dtr/2.1/guides/repos-and-images/push-an-image.md

@@ -1,7 +1,6 @@
 ---
 description: Learn how to push an image to Docker Trusted Registry.
-keywords:
+keywords: docker, registry, images, pull
-- docker, registry, images, pull
 title: Push an image to DTR
 ---
 

datacenter/dtr/2.1/guides/support.md

@@ -1,10 +1,8 @@
 ---
-title: Get support for DTR
 description: Your Docker subscription gives you access to prioritized support. You
   can file tickets via email, your the support portal.
-keywords:
+keywords: Docker, support, help
-- Docker, support
+title: Get support for DTR
-- help
 ---
 
 Your Docker Data Center, or Docker Trusted Registry subscription gives you

datacenter/dtr/2.1/guides/user-management/create-and-manage-orgs.md

@@ -1,9 +1,8 @@
 ---
-title: Create and manage organizations
 description: Learn how to set up organizations to enforce security in Docker Trusted
   Registry.
-keywords:
+keywords: docker, registry, security, permissions, organizations
-- docker, registry, security, permissions, organizations
+title: Create and manage organizations
 ---
 
 When a user creates a repository, only that user has permissions to make changes

datacenter/dtr/2.1/guides/user-management/create-and-manage-teams.md

@@ -1,9 +1,8 @@
 ---
-title: Create and manage teams
 description: Learn how to manage teams to enforce fine-grain access control in Docker
   Trusted Registry.
-keywords:
+keywords: docker, registry, security, permissions, teams
-- docker, registry, security, permissions, teams
+title: Create and manage teams
 ---
 
 You can extend the user's default permissions by granting them fine-grain

datacenter/dtr/2.1/guides/user-management/create-and-manage-users.md

@@ -1,8 +1,7 @@
 ---
-title: Create and manage users
 description: Learn how to manage user permissions in Docker Trusted Registry.
-keywords:
+keywords: docker, registry, security, permissions, users
-- docker, registry, security, permissions, users
+title: Create and manage users
 ---
 
 When using the Docker Datacenter built-in authentication, you can create users

datacenter/dtr/2.1/guides/user-management/index.md

@@ -1,8 +1,7 @@
 ---
-title: Authentication and authorization
 description: Learn about the permission levels available on Docker Trusted Registry.
-keywords:
+keywords: docker, registry, security, permissions, users
-- docker, registry, security, permissions, users
+title: Authentication and authorization
 ---
 
 With DTR you get to control which users have access to your image repositories.

datacenter/dtr/2.1/guides/user-management/permission-levels.md

@@ -1,8 +1,7 @@
 ---
-title: Permission levels
 description: Learn about the permission levels available in Docker Trusted Registry.
-keywords:
+keywords: docker, registry, security, permissions
-- docker, registry, security, permissions
+title: Permission levels
 ---
 
 Docker Trusted Registry allows you to define fine-grain permissions over image

datacenter/dtr/2.1/reference/api/index.md

@@ -1,8 +1,7 @@
 ---
-title: Docker Trusted Registry 2.1 API
 description: Learn how to use the Docker Trusted Registry REST API
-keywords:
+keywords: dtr, api, reference
-- dtr, api, reference
+title: Docker Trusted Registry 2.1 API
 ---
 
 <div class="swagger-section">

datacenter/dtr/2.1/reference/cli/backup.md

@@ -1,8 +1,7 @@
 ---
-title: docker/dtr backup
-keywords:
-- docker, dtr, cli, backup
 description: Backup a DTR cluster to a tar file and stream it to stdout
+keywords: docker, dtr, cli, backup
+title: docker/dtr backup
 ---
 
 Backup a DTR cluster to a tar file and stream it to stdout
@@ -45,4 +44,3 @@ stored securely.
 |`--ucp-ca`|Use a PEM-encoded TLS CA certificate for UCP|
 |`--existing-replica-id`|ID of an existing replica in a cluster|
 |`--config-only`|Backup/restore only the configurations of DTR and not the database|
-

datacenter/dtr/2.1/reference/cli/dumpcerts.md

@@ -1,8 +1,7 @@
 ---
-title: docker/dtr dumpcerts
-keywords:
-- docker, dtr, cli, dumpcerts
 description: Dump out the TLS certificates used by this DTR instance
+keywords: docker, dtr, cli, dumpcerts
+title: docker/dtr dumpcerts
 ---
 
 Dump out the TLS certificates used by this DTR instance
@@ -34,4 +33,3 @@ communicating across replicas with TLS.
 |`--ucp-insecure-tls`|Disable TLS verification for UCP|
 |`--ucp-ca`|Use a PEM-encoded TLS CA certificate for UCP|
 |`--existing-replica-id`|ID of an existing replica in a cluster|
-

datacenter/dtr/2.1/reference/cli/images.md

@@ -1,8 +1,7 @@
 ---
-title: docker/dtr images
-keywords:
-- docker, dtr, cli, images
 description: Lists all the images necessary to install DTR
+keywords: docker, dtr, cli, images
+title: docker/dtr images
 ---
 
 Lists all the images necessary to install DTR
@@ -18,6 +17,3 @@ docker run -it --rm docker/dtr \
 
 
 This command lists all the images necessary to install DTR.
-
-
-

datacenter/dtr/2.1/reference/cli/index.md

@@ -1,8 +1,7 @@
 ---
-title: docker/dtr overview
-keywords:
-- docker, dtr, install, uninstall, configure
 description: Learn about the commands available in the docker/dtr image.
+keywords: docker, dtr, install, uninstall, configure
+title: docker/dtr overview
 ---
 
 This tool has commands to install, configure, and backup Docker
@@ -34,4 +33,3 @@ docker run -it --rm docker/dtr \
 |`upgrade`| Upgrade a v2.0.0 or later cluster to this version of DTR|
 |`dumpcerts`| Dump out the TLS certificates used by this DTR instance|
 |`images`| Lists all the images necessary to install DTR|
-

datacenter/dtr/2.1/reference/cli/install.md

@@ -1,8 +1,7 @@
 ---
-title: docker/dtr install
-keywords:
-- docker, dtr, cli, install
 description: Install Docker Trusted Registry on this Docker Engine
+keywords: docker, dtr, cli, install
+title: docker/dtr install
 ---
 
 Install Docker Trusted Registry on this Docker Engine
@@ -56,4 +55,3 @@ the 'join' command.
 |`--replica-id`|Specify the replica ID. Must be unique per replica, leave blank for random|
 |`--unsafe`|Enable this flag to skip safety checks when installing or joining|
 |`--extra-envs`|List of extra environment variables to use for deploying the DTR containers for the replica. This can be used to specify swarm constraints. Separate the environment variables with ampersands (&). You can escape actual ampersands with backslashes (\). Can't be used in combination with --ucp-node|
-

datacenter/dtr/2.1/reference/cli/join.md

@@ -1,8 +1,7 @@
 ---
-title: docker/dtr join
-keywords:
-- docker, dtr, cli, join
 description: Add a new replica to an existing DTR cluster
+keywords: docker, dtr, cli, join
+title: docker/dtr join
 ---
 
 Add a new replica to an existing DTR cluster
@@ -39,4 +38,3 @@ the cluster.
 |`--replica-https-port`|Specify the public HTTPS port for the DTR replica; 0 means unchanged/default|
 |`--skip-network-test`|Enable this flag to skip the overlay networking test|
 |`--extra-envs`|List of extra environment variables to use for deploying the DTR containers for the replica. This can be used to specify swarm constraints. Separate the environment variables with ampersands (&). You can escape actual ampersands with backslashes (\). Can't be used in combination with --ucp-node|
-

datacenter/dtr/2.1/reference/cli/reconfigure.md

@@ -1,8 +1,7 @@
 ---
-title: docker/dtr reconfigure
-keywords:
-- docker, dtr, cli, reconfigure
 description: Change DTR configurations
+keywords: docker, dtr, cli, reconfigure
+title: docker/dtr reconfigure
 ---
 
 Change DTR configurations
@@ -56,4 +55,3 @@ effect. To have no down time, configure your DTR for high-availability.
 |`--ucp-ca`|Use a PEM-encoded TLS CA certificate for UCP|
 |`--nfs-storage-url`|URL (with IP address or hostname) of the NFS mount if using NFS (e.g. nfs://<ip address>/<mount point>)|
 |`--existing-replica-id`|ID of an existing replica in a cluster|
-

datacenter/dtr/2.1/reference/cli/remove.md

@@ -1,8 +1,7 @@
 ---
-title: docker/dtr remove
-keywords:
-- docker, dtr, cli, remove
 description: Remove a replica from a DTR cluster
+keywords: docker, dtr, cli, remove
+title: docker/dtr remove
 ---
 
 Remove a replica from a DTR cluster
@@ -36,4 +35,3 @@ DTR containers, and deletes all DTR volumes.
 |`--force-remove`|Force removal of replica even if it can break your cluster's state. Necessary only when --existing-replica-id == --replica-id.|
 |`--replica-id`|Specify the replica ID. Must be unique per replica, leave blank for random|
 |`--existing-replica-id`|ID of an existing replica in a cluster|
-

datacenter/dtr/2.1/reference/cli/restore.md

@@ -1,8 +1,7 @@
 ---
-title: docker/dtr restore
-keywords:
-- docker, dtr, cli, restore
 description: Create a new DTR cluster from an existing backup
+keywords: docker, dtr, cli, restore
+title: docker/dtr restore
 ---
 
 Create a new DTR cluster from an existing backup
@@ -65,4 +64,3 @@ the 'join' command.
 |`--ucp-node`|Specify the host to install Docker Trusted Registry|
 |`--replica-id`|Specify the replica ID. Must be unique per replica, leave blank for random|
 |`--config-only`|Backup/restore only the configurations of DTR and not the database|
-

datacenter/dtr/2.1/reference/cli/upgrade.md

@@ -1,8 +1,7 @@
 ---
-title: docker/dtr upgrade
-keywords:
-- docker, dtr, cli, upgrade
 description: Upgrade a v2.0.0 or later cluster to this version of DTR
+keywords: docker, dtr, cli, upgrade
+title: docker/dtr upgrade
 ---
 
 Upgrade a v2.0.0 or later cluster to this version of DTR
@@ -51,4 +50,3 @@ this bootstrapper.
 |`--ucp-insecure-tls`|Disable TLS verification for UCP|
 |`--ucp-ca`|Use a PEM-encoded TLS CA certificate for UCP|
 |`--existing-replica-id`|ID of an existing replica in a cluster|
-

datacenter/ucp/1.1/release_notes.md

@@ -1,12 +1,9 @@
 ---
-redirect_from:
-- /ucp/release_notes/
 description: Release notes for Docker Universal Control Plane. Learn more about the
   changes introduced in the latest versions.
-keywords:
+keywords: Docker, UCP, Release notes, Versions
-- Docker, UCP
+redirect_from:
-- Release notes
+- /ucp/release_notes/
-- Versions
 title: UCP release notes
 ---
 

datacenter/ucp/1.1/support.md

@@ -1,11 +1,9 @@
 ---
-redirect_from:
-- /ucp/support/
 description: Your Docker subscription gives you access to prioritized support. You
   can file tickets via email, your the support portal.
-keywords:
+keywords: Docker, support, help
-- Docker, support
+redirect_from:
-- help
+- /ucp/support/
 title: Get support
 ---
 

datacenter/ucp/2.0/guides/access-ucp/cli-based-access.md

@@ -1,8 +1,7 @@
 ---
-title: CLI-based access
 description: Learn how to access Docker Universal Control Plane from the CLI.
-keywords:
+keywords: docker, ucp, cli, administration
-- docker, ucp, cli, administration
+title: CLI-based access
 ---
 
 Docker UCP secures your cluster with role-based access control, so that only

datacenter/ucp/2.0/guides/access-ucp/index.md

@@ -1,8 +1,7 @@
 ---
-title: Web-based access
 description: Learn how to access Docker Universal Control Plane from the web browser.
-keywords:
+keywords: docker, ucp, web, administration
-- docker, ucp, web, administration
+title: Web-based access
 ---
 
 Docker Universal Control Plane allows you to manage your cluster in a visual

datacenter/ucp/2.0/guides/applications/deploy-app-cli.md

@@ -1,9 +1,8 @@
 ---
-title: Deploy an app from the CLI
 description: Learn how to deploy containerized applications on a swarm, with Docker
   Universal Control Plane.
-keywords:
+keywords: deploy, application
-- deploy, application
+title: Deploy an app from the CLI
 ---
 
 With Docker Universal Control Plane you can deploy your apps from the CLI,

datacenter/ucp/2.0/guides/applications/index.md

@@ -1,9 +1,8 @@
 ---
-title: Deploy an app from the UI
 description: Learn how to deploy containerized applications on a cluster, with Docker
   Universal Control Plane.
-keywords:
+keywords: ucp, deploy, application
-- ucp, deploy, application
+title: Deploy an app from the UI
 ---
 
 With Docker Universal Control Plane you can deploy applications from the

datacenter/ucp/2.0/guides/architecture.md

@@ -1,8 +1,7 @@
 ---
-title: UCP architecture
 description: Learn about the architecture of Docker Universal Control Plane.
-keywords:
+keywords: docker, ucp, architecture
-- docker, ucp, architecture
+title: UCP architecture
 ---
 
 Universal Control Plane is a containerized application that runs on the

datacenter/ucp/2.0/guides/configuration/configure-logs.md

@@ -1,9 +1,8 @@
 ---
-title: Configure UCP logging
 description: Learn how to configure Docker Universal Control Plane to store your logs
   on an external log system.
-keywords:
+keywords: docker, ucp, integrate, logs
-- docker, ucp, integrate, logs
+title: Configure UCP logging
 ---
 
 ## Configure UCP logging

datacenter/ucp/2.0/guides/configuration/index.md

@@ -1,9 +1,8 @@
 ---
-title: Use externally-signed certificates
 description: Learn how to configure Docker Universal Control Plane to use your own
   certificates.
-keywords:
+keywords: Universal Control Plane, UCP, certificate, authentiation, tls
-- Universal Control Plane, UCP, certificate, authentiation, tls
+title: Use externally-signed certificates
 ---
 
 By default the UCP web UI is exposed using HTTPS, to ensure all

datacenter/ucp/2.0/guides/configuration/integrate-with-dtr.md

@@ -1,8 +1,7 @@
 ---
-title: Integrate with Docker Trusted Registry
 description: Integrate UCP with Docker Trusted Registry
-keywords:
+keywords: trusted, registry, integrate, UCP, DTR
-- trusted, registry, integrate, UCP, DTR
+title: Integrate with Docker Trusted Registry
 ---
 
 Docker UCP integrates out of the box with Docker Trusted Registry (DTR). This

datacenter/ucp/2.0/guides/configuration/integrate-with-ldap.md

@@ -1,9 +1,8 @@
 ---
-title: Integrate with LDAP
 description: Learn how to integrate UCP with an LDAP service, so that you can manage
   users from a single place.
-keywords:
+keywords: LDAP, authentication, user management
-- LDAP, authentication, user management
+title: Integrate with LDAP
 ---
 
 Docker UCP integrates with LDAP services, so that you can manage users from a

datacenter/ucp/2.0/guides/configuration/route-hostnames.md

@@ -1,8 +1,7 @@
 ---
-title: Enable container networking with UCP
 description: Docker Universal Control Plane
-keywords:
+keywords: networking, kv, engine-discovery, ucp
-- networking, kv, engine-discovery, ucp
+title: Enable container networking with UCP
 ---
 
 UCP provides an HTTP routing mesh, that extends the networking capabilities

datacenter/ucp/2.0/guides/content-trust/index.md

@@ -1,8 +1,8 @@
 ---
+description: Configure a Docker Universal Plane cluster to only allow running applications
+  that use images you trust.
+keywords: docker, ucp, backup, restore, recovery
 title: Run only the images you trust
-description: Configure a Docker Universal Plane cluster to only allow running applications that use images you trust.
-keywords:
-- docker, ucp, backup, restore, recovery
 ---
 
 With Docker Universal Control Plane you can enforce applications to only use

datacenter/ucp/2.0/guides/content-trust/manage-trusted-repositories.md

@@ -1,8 +1,7 @@
 ---
-title: Manage trusted repositories
 description: Learn how to use the Notary CLI client to manage trusted repositories
-keywords:
+keywords: UCP, trust, notary, registry, security
-- UCP, trust, notary, registry, security
+title: Manage trusted repositories
 ---
 
 Once you install the Notary CLI client, you can use it to manage your signing

datacenter/ucp/2.0/guides/high-availability/backups-and-disaster-recovery.md

@@ -1,8 +1,8 @@
 ---
+description: Learn how to backup your Docker Universal Control Plane cluster, and
+  to recover your cluster from an existing backup.
+keywords: docker, ucp, backup, restore, recovery
 title: Backups and disaster recovery
-description: Learn how to backup your Docker Universal Control Plane cluster, and to recover your cluster from an existing backup.
-keywords:
-- docker, ucp, backup, restore, recovery
 ---
 
 When you decide to start using Docker Universal Control Plane on a production

datacenter/ucp/2.0/guides/high-availability/index.md

@@ -1,9 +1,8 @@
 ---
-title: Set up high availability
 description: Docker Universal Control plane has support for high availability. Learn
   how to set up your installation to ensure it tolerates failures.
-keywords:
+keywords: docker, ucp, high-availability, replica
-- docker, ucp, high-availability, replica
+title: Set up high availability
 ---
 
 Docker Universal Control Plane is designed for high availability (HA). You can

datacenter/ucp/2.0/guides/index.md

@@ -1,9 +1,8 @@
 ---
-title: Universal Control Plane overview
 description: Learn about Docker Universal Control Plane, the enterprise-grade cluster
   management solution from Docker.
-keywords:
+keywords: docker, ucp, overview, orchestration, clustering
-- docker, ucp, overview, orchestration, clustering
+title: Universal Control Plane overview
 ---
 
 Docker Universal Control Plane (UCP) is the enterprise-grade cluster management

datacenter/ucp/2.0/guides/installation/index.md

@@ -1,8 +1,7 @@
 ---
-title: Install UCP for production
 description: Learn how to install Docker Universal Control Plane on production
-keywords:
+keywords: Universal Control Plane, UCP, install
-- Universal Control Plane, UCP, install
+title: Install UCP for production
 ---
 
 Docker Universal Control Plane (UCP) is a containerized application that can be

datacenter/ucp/2.0/guides/installation/install-offline.md

@@ -1,9 +1,8 @@
 ---
-title: Install UCP offline
 description: Learn how to install Docker Universal Control Plane. on a machine with
   no internet access.
-keywords:
+keywords: docker, ucp, install, offline
-- docker, ucp, install, offline
+title: Install UCP offline
 ---
 
 The procedure to install Docker Universal Control Plane on a host is the same,

datacenter/ucp/2.0/guides/installation/license.md

@@ -1,8 +1,7 @@
 ---
-title: License UCP
 description: Learn how to license your Docker Universal Control Plane installation.
-keywords:
+keywords: Universal Control Plane, UCP, install, license
-- Universal Control Plane, UCP, install, license
+title: License UCP
 ---
 
 After installing Docker Universal Control Plane, you need to license your

datacenter/ucp/2.0/guides/installation/plan-production-install.md

@@ -1,9 +1,8 @@
 ---
-title: Plan a production installation
 description: Learn about the Docker Universal Control Plane architecture, and the
   requirements to install it on production.
-keywords:
+keywords: docker, ucp, install, checklist
-- docker, ucp, install, checklist
+title: Plan a production installation
 ---
 
 Docker Universal Control Plane can be installed on-premises, or

datacenter/ucp/2.0/guides/installation/scale-your-cluster.md

@@ -1,8 +1,8 @@
 ---
+description: Learn how to scale Docker Universal Control Plane cluster, by adding
+  and removing nodes.
+keywords: UCP, cluster, scale
 title: Scale your cluster
-description: Learn how to scale Docker Universal Control Plane cluster, by adding and removing nodes.
-keywords:
-- UCP, cluster, scale
 ---
 
 Docker UCP is designed for scaling horizontally as your applications grow in

datacenter/ucp/2.0/guides/installation/system-requirements.md

@@ -1,9 +1,8 @@
 ---
-title: UCP System requirements
 description: Learn about the system requirements for installing Docker Universal Control
   Plane.
-keywords:
+keywords: docker, ucp, architecture, requirements
-- docker, ucp, architecture, requirements
+title: UCP System requirements
 ---
 
 Docker Universal Control Plane can be installed on-premises or on the cloud.

datacenter/ucp/2.0/guides/installation/uninstall.md

@@ -1,8 +1,7 @@
 ---
-title: Uninstall UCP
 description: Learn how to uninstall a Docker Universal Control Plane cluster.
-keywords:
+keywords: docker, ucp, uninstall
-- docker, ucp, uninstall
+title: Uninstall UCP
 ---
 
 Docker UCP is designed to scale as your applications grow in size and usage.

datacenter/ucp/2.0/guides/installation/upgrade.md

@@ -1,12 +1,11 @@
 ---
-title: Upgrade to UCP 2.0
 description: Learn how to upgrade Docker Universal Control Plane with minimal impact
   to your users.
-keywords:
+keywords: Docker, UCP, upgrade, update
-- Docker, UCP, upgrade, update
 redirect_from:
 - /ucp/upgrade-ucp/
 - /ucp/installation/upgrade/
+title: Upgrade to UCP 2.0
 ---
 
 This page guides you in upgrading Docker Universal Control Plane (UCP) to

datacenter/ucp/2.0/guides/monitor/index.md

@@ -1,9 +1,8 @@
 ---
-title: Monitor your cluster
 description: Monitor your Docker Universal Control Plane installation, and learn how
   to troubleshoot it.
-keywords:
+keywords: Docker, UCP, troubleshoot
-- Docker, UCP, troubleshoot
+title: Monitor your cluster
 ---
 
 This article gives you an overview of how to monitor your Docker UCP

datacenter/ucp/2.0/guides/monitor/troubleshoot-configurations.md

@@ -1,8 +1,7 @@
 ---
-title: Troubleshoot cluster configurations
 description: Learn how to troubleshoot your Docker Universal Control Plane cluster.
-keywords:
+keywords: ectd, key, value, store, ucp
-- ectd, key, value, store, ucp
+title: Troubleshoot cluster configurations
 ---
 
 Docker UCP persists configuration data on an [etcd](https://coreos.com/etcd/)

datacenter/ucp/2.0/guides/monitor/troubleshoot.md

@@ -1,8 +1,7 @@
 ---
-title: Troubleshoot your cluster
 description: Learn how to troubleshoot your Docker Universal Control Plane cluster.
-keywords:
+keywords: docker, ucp, troubleshoot
-- docker, ucp, troubleshoot
+title: Troubleshoot your cluster
 ---
 
 If you detect problems in your UCP cluster, you can start your troubleshooting

datacenter/ucp/2.0/guides/release-notes.md

@@ -1,11 +1,8 @@
 ---
-title: UCP release notes
 description: Release notes for Docker Universal Control Plane. Learn more about the
   changes introduced in the latest versions.
-keywords:
+keywords: Docker, UCP, Release notes, Versions
-- Docker, UCP
+title: UCP release notes
-- Release notes
-- Versions
 ---
 
 Here you can learn about new features, bug fixes, breaking changes and

datacenter/ucp/2.0/guides/support.md

@@ -1,10 +1,8 @@
 ---
-title: Get support
 description: Your Docker subscription gives you access to prioritized support. You
   can file tickets via email, your the support portal.
-keywords:
+keywords: Docker, support, help
-- Docker, support
+title: Get support
-- help
 ---
 
 Your Docker Data Center, or Universal Control Plane subscription gives you

datacenter/ucp/2.0/guides/user-management/create-and-manage-teams.md

@@ -1,9 +1,8 @@
 ---
-title: Create and manage teams
 description: Learn how to create and manage user permissions, using teams in your
   Docker Universal Control Plane cluster.
-keywords:
+keywords: authorize, authentication, users, teams, UCP, Docker
-- authorize, authentication, users, teams, UCP, Docker
+title: Create and manage teams
 ---
 
 You can extend the user's default permissions by granting them fine-grain

datacenter/ucp/2.0/guides/user-management/create-and-manage-users.md

@@ -1,9 +1,8 @@
 ---
-title: Create and manage users
 description: Learn how to create and manage users in your Docker Universal Control
   Plane cluster.
-keywords:
+keywords: authorize, authentication, users, teams, UCP, Docker
-- authorize, authentication, users, teams, UCP, Docker
+title: Create and manage users
 ---
 
 When using the UCP built-in authentication, you need to create users and

datacenter/ucp/2.0/guides/user-management/index.md

@@ -1,8 +1,7 @@
 ---
-title: Authentication and authorization
 description: Learn how to manage permissions in Docker Universal Control Plane.
-keywords:
+keywords: authorization, authentication, users, teams, UCP
-- authorization, authentication, users, teams, UCP
+title: Authentication and authorization
 ---
 
 With Docker Universal Control Plane you get to control who can create and edit

datacenter/ucp/2.0/guides/user-management/permission-levels.md

@@ -1,9 +1,8 @@
 ---
-title: Permission levels
 description: Learn about the permission levels available in Docker Universal Control
   Plane.
-keywords:
+keywords: authorization, authentication, users, teams, UCP
-- authorization, authentication, users, teams, UCP
+title: Permission levels
 ---
 
 Docker Universal Control Plane has two types of users: administrators and

datacenter/ucp/2.0/reference/cli/backup.md

@@ -1,8 +1,7 @@
 ---
-title: docker/ucp backup
 description: Create a backup of a UCP manager node
-keywords:
+keywords: docker, dtr, cli, backup
-- docker, dtr, cli, backup
+title: docker/ucp backup
 ---
 
 Create a backup of a UCP manager node

datacenter/ucp/2.0/reference/cli/dump-certs.md

@@ -1,8 +1,7 @@
 ---
-title: docker/ucp dump-certs
 description: Print the public certificates used by this UCP web server
-keywords:
+keywords: docker, dtr, cli, dump-certs
-- docker, dtr, cli, dump-certs
+title: docker/ucp dump-certs
 ---
 
 Print the public certificates used by this UCP web server

datacenter/ucp/2.0/reference/cli/fingerprint.md

@@ -1,8 +1,7 @@
 ---
-title: docker/ucp fingerprint
 description: Print the TLS fingerprint for this UCP web server
-keywords:
+keywords: docker, dtr, cli, fingerprint
-- docker, dtr, cli, fingerprint
+title: docker/ucp fingerprint
 ---
 
 Print the TLS fingerprint for this UCP web server
@@ -23,4 +22,3 @@ docker run --rm \
 
 This command displays the fingerprint of the certificate used in the UCP web
 server running on this node.
-

datacenter/ucp/2.0/reference/cli/id.md

@@ -1,8 +1,7 @@
 ---
-title: docker/ucp id
 description: Print the ID of UCP running on this node
-keywords:
+keywords: docker, dtr, cli, id
-- docker, dtr, cli, id
+title: docker/ucp id
 ---
 
 Print the ID of UCP running on this node
@@ -26,4 +25,3 @@ matches what you see when running the 'docker info' command while using
 a client bundle.
 
 This ID is used by other commands as confirmation.
-

datacenter/ucp/2.0/reference/cli/images.md

@@ -1,8 +1,7 @@
 ---
-title: docker/ucp images
 description: Verify the UCP images on this node
-keywords:
+keywords: docker, dtr, cli, images
-- docker, dtr, cli, images
+title: docker/ucp images
 ---
 
 Verify the UCP images on this node

datacenter/ucp/2.0/reference/cli/index.md

@@ -1,8 +1,7 @@
 ---
-title: docker/ucp overview
 description: Learn about the commands available in the docker/ucp image.
-keywords:
+keywords: docker, ucp, cli, ucp
-- docker, ucp, cli, ucp
+title: docker/ucp overview
 ---
 
 This image has commands to install and manage

datacenter/ucp/2.0/reference/cli/install.md

@@ -1,8 +1,7 @@
 ---
-title: docker/ucp install
 description: Install UCP on this node
-keywords:
+keywords: docker, dtr, cli, install
-- docker, dtr, cli, install
+title: docker/ucp install
 ---
 
 Install UCP on this node

datacenter/ucp/2.0/reference/cli/restart.md

@@ -1,8 +1,7 @@
 ---
-title: docker/ucp restart
 description: Start or restart UCP components running on this node
-keywords:
+keywords: docker, dtr, cli, restart
-- docker, dtr, cli, restart
+title: docker/ucp restart
 ---
 
 Start or restart UCP components running on this node

datacenter/ucp/2.0/reference/cli/restore.md

@@ -1,8 +1,7 @@
 ---
-title: docker/ucp restore
 description: Restore a UCP manager node from a backup
-keywords:
+keywords: docker, dtr, cli, restore
-- docker, dtr, cli, restore
+title: docker/ucp restore
 ---
 
 Restore a UCP manager node from a backup

datacenter/ucp/2.0/reference/cli/stop.md

@@ -1,8 +1,7 @@
 ---
-title: docker/ucp stop
 description: Stop UCP components running on this node
-keywords:
+keywords: docker, dtr, cli, stop
-- docker, dtr, cli, stop
+title: docker/ucp stop
 ---
 
 Stop UCP components running on this node

datacenter/ucp/2.0/reference/cli/support.md

@@ -1,8 +1,7 @@
 ---
-title: docker/ucp support
 description: Create a support dump for this UCP node
-keywords:
+keywords: docker, dtr, cli, support
-- docker, dtr, cli, support
+title: docker/ucp support
 ---
 
 Create a support dump for this UCP node
@@ -22,4 +21,3 @@ docker run --rm \
 ## Description
 
 This command creates a support dump file for this node, and prints it to stdout.
-

datacenter/ucp/2.0/reference/cli/uninstall-ucp.md

@@ -1,8 +1,7 @@
 ---
-title: docker/ucp uninstall-ucp
 description: Uninstall UCP from this swarm
-keywords:
+keywords: docker, dtr, cli, uninstall-ucp
-- docker, dtr, cli, uninstall-ucp
+title: docker/ucp uninstall-ucp
 ---
 
 Uninstall UCP from this swarm

datacenter/ucp/2.0/reference/cli/upgrade.md

@@ -1,8 +1,7 @@
 ---
-title: docker/ucp upgrade
 description: Upgrade the UCP components on this node
-keywords:
+keywords: docker, dtr, cli, upgrade
-- docker, dtr, cli, upgrade
+title: docker/ucp upgrade
 ---
 
 Upgrade the UCP components on this node

engine/admin/troubleshooting_volume_errors.md

@@ -1,7 +1,6 @@
 ---
 description: Troubleshooting volume errors
-keywords:
+keywords: cadvisor, troubleshooting, volumes, bind-mounts
-- cadvisor, troubleshooting, volumes, bind-mounts
 title: Troubleshoot volume errors
 ---
 

engine/breaking_changes.md

@@ -2,9 +2,7 @@
 redirect_from:
 - /engine/misc/breaking/
 description: Breaking changes
-keywords:
+keywords: docker, documentation, about, technology, breaking, incompatibilities
-- docker, documentation, about, technology, breaking
-- incompatibilities
 title: Breaking changes and incompatibilities
 ---
 

engine/getstarted/step_four.md

@@ -4,8 +4,7 @@ redirect_from:
 - /windows/step_four/
 - /linux/step_four/
 description: Getting started with Docker
-keywords:
+keywords: beginner, getting started, Docker
-- beginner, getting started, Docker
 title: Build your own image
 ---
 

engine/installation/linux/index.md

@@ -1,10 +1,6 @@
 ---
 description: Lists the installation methods
-keywords:
+keywords: docker, engine, install, linux
-- docker
-- engine
-- install
-- linux
 title: Install Docker on Linux distributions
 ---
 

engine/swarm/how-swarm-mode-works/pki.md

@@ -1,13 +1,6 @@
 ---
 description: How PKI works in swarm mode
-keywords:
+keywords: docker, container, cluster, swarm mode, node, tls, pki
-- docker
-- container
-- cluster
-- swarm mode
-- node
-- tls
-- pki
 title: How PKI works in swarm mode
 ---
 

engine/swarm/ingress.md

@@ -1,12 +1,6 @@
 ---
 description: Use the routing mesh to publish services externally to a swarm
-keywords:
+keywords: guide, swarm mode, swarm, network, ingress, routing mesh
-- guide
-- swarm mode
-- swarm
-- network
-- ingress
-- routing mesh
 title: Use swarm mode routing mesh
 ---
 

engine/swarm/networking.md

@@ -1,10 +1,6 @@
 ---
 description: Use swarm mode networking features
-keywords:
+keywords: guide, swarm mode, swarm, network
-- guide
-- swarm mode
-- swarm
-- network
 title: Attach services to an overlay network
 ---
 

engine/swarm/services.md

@@ -1,10 +1,6 @@
 ---
 description: Deploy services to a swarm
-keywords:
+keywords: guide, swarm mode, swarm, service
-- guide
-- swarm mode
-- swarm
-- service
 title: Deploy services to a swarm
 ---
 

engine/tutorials/usingdocker.md

@@ -2,9 +2,7 @@
 redirect_from:
 - /engine/userguide/containers/usingdocker/
 description: Learn how to manage and operate Docker containers.
-keywords:
+keywords: docker, the docker guide, documentation, docker.io, monitoring containers, docker top, docker inspect, docker port, ports, docker logs, log, logs
-- docker, the docker guide, documentation, docker.io, monitoring containers,
-  docker top, docker inspect, docker port, ports, docker logs, log, logs
 menu:
   main:
     parent: engine_learn_menu

engine/userguide/networking/overlay-security-model.md

@@ -1,8 +1,6 @@
 ---
 description: Docker swarm mode overlay network security model
-keywords:
+keywords: network, docker, documentation, user guide, multihost, swarm mode, overlay
-- network, docker, documentation, user guide, multihost, swarm mode
-- overlay
 title: Docker swarm mode overlay network security model
 ---
 

tests/Dockerfile

@@ -1,12 +1,8 @@
 FROM golang:1.7.3-alpine
-MAINTAINER Gaetan de Villele <gaetan@docker.com>
+MAINTAINER Adrien Duermael <adrien@docker.com>
-
-RUN apk update
-RUN apk add git
 
 COPY src /go/src
 WORKDIR /go/src/validator
 
 # when running the container, MOUNT docs repo in /docs
-
 CMD ["go", "test"]

tests/src/validator/markdown_test.go

@@ -2,7 +2,6 @@ package main
 
 import (
 	"errors"
-	"fmt"
 	"github.com/gdevillele/frontparser"
 	"io/ioutil"
 	"os"
@@ -12,50 +11,114 @@ import (
 )
 
 // TestFrontmatterTitle tests if there's a title present in all
-// markdown frontmatters.
+// published markdown frontmatters.
 func TestFrontmatterTitle(t *testing.T) {
 	filepath.Walk("/docs", func(path string, info os.FileInfo, err error) error {
-		err = testFrontmatterTitle(path)
 		if err != nil {
-			fmt.Println(err.Error(), "-", path)
+			t.Error(err.Error(), "-", path)
-			t.Fail()
+		}
+		published, mdBytes, err := isPublishedMarkdown(path)
+		if err != nil {
+			t.Error(err.Error(), "-", path)
+		}
+		if published == false {
+			return nil
+		}
+		err = testFrontmatterTitle(mdBytes)
+		if err != nil {
+			t.Error(err.Error(), "-", path)
 		}
 		return nil
 	})
 }
 
 // testFrontmatterTitle tests if there's a title present in
-// markdown file at given path
+// given markdown file bytes
-func testFrontmatterTitle(path string) error {
+func testFrontmatterTitle(mdBytes []byte) error {
-	if strings.HasSuffix(path, ".md") {
+	fm, _, err := frontparser.ParseFrontmatterAndContent(mdBytes)
-		fileBytes, err := ioutil.ReadFile(path)
+	if err != nil {
-		if err != nil {
+		return err
-			return err
+	}
-		}
+	if _, exists := fm["title"]; exists == false {
-		// if file has frontmatter
+		return errors.New("can't find title in frontmatter")
-		if frontparser.HasFrontmatterHeader(fileBytes) {
-			fm, _, err := frontparser.ParseFrontmatterAndContent(fileBytes)
-			if err != nil {
-				return err
-			}
-
-			// skip markdowns that are not published
-			if published, exists := fm["published"]; exists {
-				if publishedBool, ok := published.(bool); ok {
-					if publishedBool == false {
-						return nil
-					}
-				}
-			}
-
-			if _, exists := fm["title"]; exists == false {
-				return errors.New("can't find title in frontmatter")
-			}
-		} else {
-			// no frontmatter is not an error
-			// markdown files without frontmatter won't be considered
-			return nil
-		}
 	}
 	return nil
 }
+
+// TestFrontMatterKeywords tests if keywords are present and correctly
+// formatted in all published markdown frontmatters.
+func TestFrontMatterKeywords(t *testing.T) {
+	filepath.Walk("/docs", func(path string, info os.FileInfo, err error) error {
+		if err != nil {
+			t.Error(err.Error(), "-", path)
+		}
+		published, mdBytes, err := isPublishedMarkdown(path)
+		if err != nil {
+			t.Error(err.Error(), "-", path)
+		}
+		if published == false {
+			return nil
+		}
+		err = testFrontMatterKeywords(mdBytes)
+		if err != nil {
+			t.Error(err.Error(), "-", path)
+		}
+		return nil
+	})
+}
+
+// testFrontMatterKeywords tests if if keywords are present and correctly
+// formatted in given markdown file bytes
+func testFrontMatterKeywords(mdBytes []byte) error {
+	fm, _, err := frontparser.ParseFrontmatterAndContent(mdBytes)
+	if err != nil {
+		return err
+	}
+
+	keywords, exists := fm["keywords"]
+
+	// it's ok to have a page without keywords
+	if exists == false {
+		return nil
+	}
+
+	if _, ok := keywords.(string); !ok {
+		return errors.New("keywords should be a comma separated string")
+	}
+
+	return nil
+}
+
+//-----------------
+// utils
+//-----------------
+
+// isPublishedMarkdown returns wether a file is a published markdown or not
+// as a convenience it also returns the markdown bytes to avoid reading files twice
+func isPublishedMarkdown(path string) (bool, []byte, error) {
+	if strings.HasSuffix(path, ".md") {
+		fileBytes, err := ioutil.ReadFile(path)
+		if err != nil {
+			return false, nil, err
+		}
+		if frontparser.HasFrontmatterHeader(fileBytes) {
+			fm, _, err := frontparser.ParseFrontmatterAndContent(fileBytes)
+			if err != nil {
+				return false, nil, err
+			}
+			// skip markdowns that are not published
+			if published, exists := fm["published"]; exists {
+				if publishedBool, ok := published.(bool); ok {
+					if publishedBool {
+						// file is markdown, has frontmatter and is published
+						return true, fileBytes, nil
+					}
+				}
+			} else {
+				// if "published" field is missing, it means published == true
+				return true, fileBytes, nil
+			}
+		}
+	}
+	return false, nil, nil
+}