Converges titles to imperative-form, front-matter based, and sentence…

…-case (docker#438) Multiple title fixes, consistency fixes, convergence into metadata-based titles.
BrankuzziJS · Nov 4, 2016 · 558314b · 558314b
1 parent 9bf89d4
commit 558314b
Show file tree

Hide file tree

Showing 672 changed files with 2,091 additions and 5,677 deletions.
diff --git a/_layouts/docs.html b/_layouts/docs.html
@@ -185,6 +185,7 @@
             </div>
             <div {% if page.notoc %} class="col-xs-12 col-sm-9 col-md-10" {% else %} class="col-xs-12 col-sm-9 col-md-8 col-xl-9" {% endif %} >
               <section class="section" id="DocumentationText">
+								{% if page.title %}<h1>{{ page.title }}</h1>{% endif %}
               {{ content }}
 							{% if page.noratings != true %}
 							<div style="text-align: center; margin-top: 50px">

diff --git a/apidocs/index.md b/apidocs/index.md
@@ -2,17 +2,9 @@
 description: Learn how to use DTR APIs.
 keywords:
 - docker, registry, DTR, APIs
-menu:
-  main:
-    identifier: smn_dtrapi
-    parent: workw_dtr
-    weight: "100"
 title: DTR APIs
-type: _default
 ---
 
-# DTR APIs
-
 This section includes the following topics:
 
 * [API overview](overview.md)
diff --git a/apidocs/overview.md b/apidocs/overview.md
@@ -2,17 +2,9 @@
 description: Learn how to use DTR APIs.
 keywords:
 - docker, registry, DTR, APIs
-menu:
-  main:
-    identifier: dtr_api_overview
-    parent: smn_dtrapi
-    weight: 0
-title: Overview
-type: _default
+title: API overview
 ---
 
-# API Overview
-
 Docker Trusted Registry has an experimental API that you can use to manage
 DTR repositories, permissions, and settings.
 

diff --git a/compose/bundles.md b/compose/bundles.md
@@ -1,17 +1,11 @@
 ---
 advisory: experimental
-description: Description of Docker and Compose's experimental support for application
-  bundles
+description: Description of Docker and Compose's experimental support for application bundles
 keywords:
 - documentation, docs,  docker, compose, bundles, stacks
-menu:
-  main:
-    parent: workw_compose
-title: Docker Stacks and Distributed Application Bundles
+title: Docker stacks and distributed application bundles (experimental)
 ---
 
-# Docker Stacks and Distributed Application Bundles (experimental)
-
 > **Note**: This is a copy of the [Docker Stacks and Distributed Application
 > Bundles](https://github.com/docker/docker/blob/v1.12.0-rc4/experimental/docker-stacks-and-bundles.md)
 > document in the [docker/docker repo](https://github.com/docker/docker).

diff --git a/compose/completion.md b/compose/completion.md
@@ -2,15 +2,9 @@
 description: Compose CLI reference
 keywords:
 - fig, composition, compose, docker, orchestration, cli,  reference
-menu:
-  main:
-    parent: workw_compose
-    weight: 88
-title: Command-line Completion
+title: Command-line completion
 ---
 
-# Command-line Completion
-
 Compose comes with [command completion](http://en.wikipedia.org/wiki/Command-line_completion)
 for the bash and zsh shell.
 

diff --git a/compose/compose-file.md b/compose/compose-file.md
@@ -4,15 +4,9 @@ aliases:
 description: Compose file reference
 keywords:
 - fig, composition, compose, docker
-menu:
-  main:
-    parent: workw_compose
-    weight: 70
-title: Compose File Reference
+title: Compose file reference
 ---
 
-# Compose file reference
-
 The Compose file is a [YAML](http://yaml.org/) file defining
 [services](compose-file.md#service-configuration-reference),
 [networks](compose-file.md#network-configuration-reference) and

diff --git a/compose/django.md b/compose/django.md
@@ -2,15 +2,9 @@
 description: Getting started with Docker Compose and Django
 keywords:
 - documentation, docs,  docker, compose, orchestration, containers
-menu:
-  main:
-    parent: workw_compose
-    weight: 4
-title: 'Quickstart: Compose and Django'
+title: "Quickstart: Compose and Django"
 ---
 
-# Quickstart: Docker Compose and Django
-
 This quick-start guide demonstrates how to use Docker Compose to set up and run a simple Django/PostgreSQL app. Before starting, you'll need to have
 [Compose installed](install.md).
 

diff --git a/compose/env-file.md b/compose/env-file.md
@@ -1,16 +1,10 @@
 ---
-description: Declaring default environment variables in file
+description: Declare default environment variables in a file
 keywords:
 - fig, composition, compose, docker, orchestration, environment, env file
-menu:
-  main:
-    parent: workw_compose
-    weight: 10
-title: Environment file
+title: Declare default environment variables in file
 ---
 
-# Environment file
-
 Compose supports declaring default environment variables in an environment
 file named `.env` placed in the folder `docker-compose` command is executed from
 *(current working directory)*.

diff --git a/compose/environment-variables.md b/compose/environment-variables.md
@@ -2,15 +2,9 @@
 description: How to set, use and manage environment variables in Compose
 keywords:
 - fig, composition, compose, docker, orchestration, environment, variables, env file
-menu:
-  main:
-    parent: workw_compose
-    weight: 10
 title: Environment variables in Compose
 ---
 
-# Environment variables in Compose
-
 There are multiple parts of Compose that deal with environment variables in one sense or another. This page should help you find the information you need.
 
 

diff --git a/compose/extends.md b/compose/extends.md
@@ -1,17 +1,10 @@
 ---
-description: How to use Docker Compose's extends keyword to share configuration between
-  files and projects
+description: How to use Docker Compose's extends keyword to share configuration between files and projects
 keywords:
 - fig, composition, compose, docker, orchestration, documentation, docs
-menu:
-  main:
-    parent: workw_compose
-    weight: 20
-title: Extending Services in Compose
+title: Share Compose configurations between files and projects
 ---
 
-# Extending services and Compose files
-
 Compose supports two methods of sharing common configuration:
 
 1. Extending an entire Compose file by

diff --git a/compose/faq.md b/compose/faq.md
@@ -1,16 +1,9 @@
 ---
 description: Docker Compose FAQ
 keywords: documentation, docs,  docker, compose, faq
-menu:
-  main:
-    identifier: faq.compose
-    parent: workw_compose
-    weight: 90
-title: Frequently Asked Questions
+title: Frequently asked questions
 ---
 
-# Frequently asked questions
-
 If you don’t see your question here, feel free to drop by `#docker-compose` on
 freenode IRC and ask the community.
 

diff --git a/compose/gettingstarted.md b/compose/gettingstarted.md
@@ -1,16 +1,10 @@
 ---
-description: Getting started with Docker Compose
+description: Get started with Docker Compose
 keywords:
 - documentation, docs,  docker, compose, orchestration, containers
-menu:
-  main:
-    parent: workw_compose
-    weight: -85
-title: Getting Started
+title: Get started with Docker Compose
 ---
 
-# Getting Started
-
 On this page you build a simple Python web application running on Docker Compose. The
 application uses the Flask framework and increments a value in Redis. While the
 sample uses Python, the concepts demonstrated here should be understandable even

diff --git a/compose/index.md b/compose/index.md
@@ -2,15 +2,9 @@
 description: Introduction and Overview of Compose
 keywords:
 - documentation, docs,  docker, compose, orchestration,  containers
-menu:
-  main:
-    identifier: workw_compose
-    weight: -70
 title: Docker Compose
 ---
 
-# Docker Compose
-
 Compose is a tool for defining and running multi-container Docker applications. To learn more about Compose refer to the following documentation:
 
 - [Compose Overview](overview.md)

diff --git a/compose/install.md b/compose/install.md
@@ -2,15 +2,9 @@
 description: How to install Docker Compose
 keywords:
 - compose, orchestration, install, installation, docker, documentation
-menu:
-  main:
-    parent: workw_compose
-    weight: -90
-title: Install Compose
+title: Install Docker Compose
 ---
 
-# Install Docker Compose
-
 You can run Compose on macOS, Windows and 64-bit Linux. To install it, you'll need to install Docker first.
 
 To install Compose, do the following:

diff --git a/compose/link-env-deprecated.md b/compose/link-env-deprecated.md
@@ -4,15 +4,9 @@ aliases:
 description: Compose CLI reference
 keywords:
 - fig, composition, compose, docker, orchestration, cli,  reference
-menu:
-  main:
-    parent: workw_compose
-    weight: 89
-title: Link Environment Variables
+title: Link environment variables (superseded)
 ---
 
-# Link environment variables reference
-
 > **Note:** Environment variables are no longer the recommended method for connecting to linked services. Instead, you should use the link name (by default, the name of the linked service) as the hostname to connect to. See the [docker-compose.yml documentation](compose-file.md#links) for details.
 >
 > Environment variables will only be populated if you're using the [legacy version 1 Compose file format](compose-file.md#versioning).

diff --git a/compose/networking.md b/compose/networking.md
@@ -2,15 +2,9 @@
 description: How Compose sets up networking between containers
 keywords:
 - documentation, docs,  docker, compose, orchestration, containers, networking
-menu:
-  main:
-    parent: workw_compose
-    weight: 21
 title: Networking in Compose
 ---
 
-# Networking in Compose
-
 > **Note:** This document only applies if you're using [version 2 of the Compose file format](compose-file.md#versioning). Networking features are not supported for version 1 (legacy) Compose files.
 
 By default Compose sets up a single

diff --git a/compose/overview.md b/compose/overview.md
@@ -2,15 +2,9 @@
 description: Introduction and Overview of Compose
 keywords:
 - documentation, docs,  docker, compose, orchestration,  containers
-menu:
-  main:
-    parent: workw_compose
-    weight: -99
 title: Overview of Docker Compose
 ---
 
-# Overview of Docker Compose
-
 Compose is a tool for defining and running multi-container Docker applications.
 With Compose, you use a Compose file to configure your application's services.
 Then, using a single command, you create and start all the services

diff --git a/compose/production.md b/compose/production.md
@@ -2,15 +2,9 @@
 description: Guide to using Docker Compose in production
 keywords:
 - documentation, docs,  docker, compose, orchestration, containers,  production
-menu:
-  main:
-    parent: workw_compose
-    weight: 22
-title: Using Compose in Production
+title: Using Compose in production
 ---
 
-## Using Compose in production
-
 When you define your app with Compose in development, you can use this
 definition to run your application in different environments such as CI,
 staging, and production.

diff --git a/compose/rails.md b/compose/rails.md
@@ -2,15 +2,9 @@
 description: Getting started with Docker Compose and Rails
 keywords:
 - documentation, docs,  docker, compose, orchestration, containers
-menu:
-  main:
-    parent: workw_compose
-    weight: 5
-title: 'Quickstart: Compose and Rails'
+title: "Quickstart: Compose and Rails"
 ---
 
-## Quickstart: Docker Compose and Rails
-
 This Quickstart guide will show you how to use Docker Compose to set up and run a Rails/PostgreSQL app. Before starting, you'll need to have [Compose installed](install.md).
 
 ### Define the project

diff --git a/compose/reference/build.md b/compose/reference/build.md
@@ -1,16 +1,10 @@
 ---
-description: build
+description: docker-compose build
 keywords:
 - fig, composition, compose, docker, orchestration, cli,  build
-menu:
-  main:
-    identifier: build.compose
-    parent: smn_compose_cli
-title: build
+title: docker-compose build
 ---
 
-# build
-
 ```
 Usage: build [options] [SERVICE...]
 

diff --git a/compose/reference/bundle.md b/compose/reference/bundle.md
@@ -2,15 +2,9 @@
 description: Create a distributed application bundle from the Compose file.
 keywords:
 - fig, composition, compose, docker, orchestration, cli,  bundle
-menu:
-  main:
-    identifier: bundle.compose
-    parent: smn_compose_cli
-title: bundle
+title: docker-compose bundle
 ---
 
-# bundle
-
 ```
 Usage: bundle [options]
 

diff --git a/compose/reference/config.md b/compose/reference/config.md
@@ -2,15 +2,9 @@
 description: Config validates and view the compose file.
 keywords:
 - fig, composition, compose, docker, orchestration, cli, config
-menu:
-  main:
-    identifier: config.compose
-    parent: smn_compose_cli
-title: config
+title: docker-compose config
 ---
 
-# config
-
 ```:
 Usage: config [options]
 

diff --git a/compose/reference/create.md b/compose/reference/create.md
@@ -2,15 +2,9 @@
 description: Create creates containers for a service.
 keywords:
 - fig, composition, compose, docker, orchestration, cli, create
-menu:
-  main:
-    identifier: create.compose
-    parent: smn_compose_cli
-title: create
+title: docker-compose create
 ---
 
-# create
-
 ```
 Creates containers for a service.