Re-write Orgs & Webhooks docs

Author: Jeffrey Morgan

_data/toc.yaml

@@ -3628,17 +3628,19 @@ manuals:
 - sectiontitle: Docker Hub
   section:
   - path: /docker-hub/
-    title: Get Started
-  - path: /docker-hub/accounts/
-    title: Docker ID
+    title: Quickstart
   - path: /docker-hub/repos/
-    title: Public Repositories
+    title: Repositories
   - path: /docker-hub/official_images/
     title: Official Images
   - path: /docker-hub/orgs/
     title: Teams & Organizations
+  - path: /docker-hub/upgrade/
+    title: Upgrading your plan
   - path: /docker-hub/webhooks/
-    title: Repository Webhooks
+    title: Webhooks
+  - path: /docker-hub/slack_integration/
+    title: Slack Integration
   - sectiontitle: Builds
     section:
       - path: /docker-hub/builds/

docker-hub/accounts.md

@@ -1,10 +1,11 @@
 ---
-description: Get Started with Docker Hub
+description: Docker Hub Quickstart
 keywords: Docker, docker, registry, accounts, plans, Dockerfile, Docker Hub, docs, documentation, accounts, organizations, repositories, groups, teams
-title: Get Started with Docker Hub
+title: Docker Hub Quickstart
 redirect_from:
 - /docker-hub/overview/
 - /apidocs/docker-cloud/
+- /docker-cloud/
 - /docker-cloud/migration/
 - /docker-cloud/migration/cloud-to-swarm/
 - /docker-cloud/migration/cloud-to-kube-aks/
@@ -72,84 +73,82 @@ redirect_from:
 - /docker-cloud/docker-errors-faq/
 - /docker-cloud/release-notes/
 - /docker-store/
-
 ---
 
-[Docker Hub](https://hub.docker.com) is a service provided by Docker for finding and sharing container images with your team.
-
-![Docker Hub Landing Page](/docker-hub/images/getting-started.png)
-
-Docker Hub provides the following major features:
-
-* [Repositories](/docker-hub/repos.md): Push and pull container images. Private
-  repositories allow you to share container images with your team. Public
-  repositories allow you to share them with anyone.
-* [Teams & Organizations](/docker-hub/orgs.md): Manage access to private repositories.
+[Docker Hub](https://hub.docker.com) is a service provided by Docker for finding and sharing container images with your team. It provides the following major features:
+* [Repositories](/docker-hub/repos.md): Push and pull container images.
+* [Teams & Organizations](/docker-hub/orgs.md): Manage access to private repositories of container images.
 * [Official Images](/docker-hub/official_images.md): Pull & use high-quality container images provided by Docker.
 * [Publisher Images](/docker-hub/publish/customer_faq.md): Pull & use high-quality container
   images provided by external vendors. Certified images also include support and guarantee
   compatibility with Docker Enterprise.
-* [Builds](/docker-hub/builds.md): Automatically build container images and push them to your repositories when you make changes to code in GitHub or BitBucket.
+* [Builds](/docker-hub/builds.md): Automatically build container images from GitHub and Bitbucket and push them to Docker Hub
 * [Webhooks](/docker-hub/webhooks.md): Trigger actions after a successful push
   to a repository to integrate Docker Hub with other services.
 
 
-## Sign up for Docker Hub
 
-Start by creating an [account](/docker-hub/accounts.md) at [https://hub.docker.com](https://hub.docker.com).
+### Step 1: Sign up for Docker Hub
 
-> **Note**: You can search for and pull Docker images from Hub without logging
-> in, however to push images or share them with your team, you must log in.
+Start by [creating an account](https://hub.docker.com/signup).
 
-## Find & Pull an Official Image
+### Step 2: Create your first repository
 
-Docker Hub contains a number of [Official
-Repositories](http://hub.docker.com/explore/). These are curated repositories from vendors and contributors to Docker. They contain Docker images from vendors like Canonical, Oracle, and Elastic that you can use as the basis to build your applications and services.
+To create a repo:
+1. Sign in to [Docker Hub](https://hub.docker.com)
+2. Click on Create Repository on the Docker Hub welcome page:
 
-With Official Images you know you're using an optimized and
-up-to-date image that was built by experts to power your applications.
+![Welcome](images/index-welcome.png)
 
-> **Note**: If you would like to contribute an Official Image for your
-> organization or product, see the documentation on
-> [Official Images on Docker Hub](/docker-hub/official_images.md) for more
-> information.
+3. Name it **<your_username>/my-first-repo** as shown below. Select **Private**:
 
-## Create your first repository and push an image to it
+![Create Repository](images/index-create-repo.png)
 
-To create a repo:
-1. Log into [Docker Hub](https://hub.docker.com)
-2. Click on Create Repositories on the home page:
-3. Name it <your namespace>/<redis>
+You've created your first repo. You should see:
+
+![Repository Created](images/index-repo-created.png)
 
-Next, we'll push an images
+### Step 3: Download and install Docker Desktop
 
-1. Download [Docker Desktop](https://docker.com/get-started)
-2. `docker pull redis` to pull the Official **redis** image from Docker Hub
-3. `docker tag redis <namespace>/redis`
-4. `docker push <namespace>/redis`
+We'll need to download Docker Desktop to build and push a container image to Docker Hub.
 
-(insert pic here)
+1. Download and install [Docker Desktop](https://docker.com/get-started). If on Linux, download [Docker Engine - Community](https://hub.docker.com/search?type=edition&offering=community)
+2. Open the terminal and sign in to Docker Hub on your computer by running `docker login`
 
-## Upgrading your Plan
+### Step 4: Build and push an image to Docker Hub from your computer
 
-Your Docker ID includes one private Docker Hub repository for free. If you need
-more private repositories, you can upgrade from your free account to a paid
-plan.
+1. Create a Dockerfile to specify your application by running:
 
-To upgrade, log in to Docker Hub and click [Upgrade Plan](https://hub.docker.com/account/billing-plans/), in the dropdown menu.
+```shell
+cat > Dockerfile <<EOF
+FROM busybox
+CMD echo "Hello world! This is my first Docker image."
+EOF
+```
 
-(insert pic here)
+More on Dockerfiles [here](https://docs.docker.com/engine/reference/builder/)
+
+2. Run `docker build -t <your_username>/my-first-repo .` to build your Docker image
+3. Test your docker image locally by running `docker run <your_username>/my-first-repo`
+4. Run `docker push <your_username>/my-first-repo` to push your Docker image to Docker Hub
+
+You should see something similar to:
+
+![Terminal](images/index-terminal.png)
+
+And in Docker Hub, your repository should have a new `latest` tag available under **Tags**:
+
+![Tag Created](images/index-tag.png)
+
+Congratulations! You've successfully:
+- Signed up for Docker Hub
+- Created your first repository
+- Built a Docker image on your computer
+- Pushed it to Docker Hub
 
 ### Next Steps
 
-You've successfully create a repo and pushed a Docker image to it. Next:
-- Create an [Organization](/docker-hub/orgs.md) to use Docker Hub with your team.
-- Automatically build container images from code via [Builds](/docker-hub/builds/index.md).
+- Create an [Organization](orgs.md) to use Docker Hub with your team.
+- Automatically build container images from code via [Builds](builds/index.md).
 - [Explore](https://hub.docker.com/explore) Official & Publisher Images
-
-### Docker Commands to Interact with Docker Hub
-Docker itself provides access to Docker Hub services via the
-[`docker search`](/engine/reference/commandline/search.md),
-[`pull`](/engine/reference/commandline/pull.md),
-[`login`](/engine/reference/commandline/login.md), and
-[`push`](/engine/reference/commandline/push.md) commands.
+- [Upgrade your plan](upgrade.md) to push additional private Docker images to Docker Hub

docker-hub/images/index-create-repo.png

@@ -1,57 +1,88 @@
 ---
-description: Docker Hub Teams and Organizations
+description: Docker Hub Teams & Organizations
 keywords: Docker, docker, registry, teams, organizations, plans, Dockerfile, Docker Hub, docs, documentation
-title: Organizations and teams in Docker Hub
+title: Teams & Organizations
 redirect_from:
 - /docker-cloud/orgs/
 ---
 
-Docker Hub [organizations](https://hub.docker.com/organizations/) let you create
-teams so you can give colleagues access to shared image repositories. A Docker
-Hub organization can contain public and private repositories just like a user
-account. Access to push or pull for these repositories is allocated by defining
-teams of users and then assigning team rights to specific repositories.
-Repository creation is limited to users in the organization owner's group. This
-allows you to distribute limited access Docker images, and to select which
-Docker Hub users can publish new images.
+Docker Hub Organizations let you create teams so you can give your team access to shared image repositories.
 
-### Create an organization
+### How Organizations & Teams Work
 
-You can see which organizations you belong to and add new organizations by
-clicking **Organizations** in the top nav bar.
+- **Organizations** are a collection of teams and repositories that can be managed together.
+- **Teams** are groups of Docker Hub users that belong to your organization.
 
-![organizations](images/orgs.png)
+**Note:** in Docker Hub, users cannot be associated directly to an organization. They below only to teams within an the organization.
 
-### Create a team
+### Creating an organization
 
-Users in the "Owners" team of an organization can create and modify the
-membership of all teams.
+1. Start by clicking on [Organizations](https://cloud.docker.com/orgs) in Docker Hub
+2. Click on "Create Organization"
+3. Provide information about your organization:
 
-Other users can only see teams they belong to.
+![Create Organization](images/orgs-create.png)
 
-![teams](images/groups.png)
+You've created an organization. You'll see you have a team, the **owners** team with a single member (you!)
 
-### Add a member to a team
+### The owners team
 
-### Manage team permissions
+The **owners** team is a special team that has full access to all repositories in the Organization.
 
-Use teams to manage who can interact with your repositories.
+Members of this team can:
+- Manage Organization settings and billing.
+- Create a team and modify the membership of any team
+- Access and modify any repository belonging to the Organization
 
-You need to be a member of the organization's "Owners" team to create a new
-team, Hub repository, or automated build. As an "Owner", you then delegate the
-following repository access rights to a team using the "Collaborators" section
-of the repository view.
+### Creating a team
+
+To create a team:
+
+1. Go to your organization by clicking on **Organizations** in Docker Hub, and select your organization.
+2. Click **Create Team** ![Create Team](images/orgs-team-create.png)
+3. Fill out your team's information and click **Create** ![Create Modal](images/orgs-team-create-submit.png)
+
+### Adding a member to a team
+
+1. Visit your team's page in Docker Hub. Click on **Organizations** > **_Your Organization_** > **_Your Team Name_**
+2. Click on **Add User**
+3. Provide the user's Docker ID username _or_ email to add them to the team ![Add User to Team](images/orgs-team-add-user.png)
+
+**Note:** you are not automatically added to teams created by your.
+
+### Removing team members
+
+To remove a member from a team, click the **x** next to their name:
+
+![Add User to Team](images/orgs-team-remove-user.png)
+
+### Giving a team access to a repository
+
+To provide a team to access a repository:
+
+1. Visit the repository list on Docker Hub by clicking on **Repositories**
+2. Select your organization in the namespace dropdown list
+3. Click the repository you'd like to edit ![Org Repos](images/orgs-list-repos.png)
+4. Click the **Permissions** tab
+5. Select the team, permissions level (more on this below) and click **+**
+6. Click the **+** button to add ![Add Repo Permissions for Team](images/orgs-add-team-permissions.png)
+
+### Viewing a team's permissions for all repositories
+
+To view a team's permissions over all repos:
+1. Click on **Organizations**, then select your organization and team.
+2. Click on the **Permissions** tab where you can view which repositories this team has access to ![Team Audit Permissions](images/orgs-audit-permissions.png)
+
+
+### Permissions Reference
 
 Permissions are cumulative. For example, if you have Write permissions, you
 automatically have Read permissions:
 
 - `Read` access allows users to view, search, and pull a private repository in the same way as they can a public repository.
-- `Write` access allows users to push to non-automated repositories on the Docker Hub.
+- `Write` access allows users to push to repositories on Docker Hub.
 - `Admin` access allows users to modify the repositories "Description", "Collaborators" rights, "Public/Private" visibility and "Delete".
 
 > **Note**: A User who has not yet verified their email address only has
 > `Read` access to the repository, regardless of the rights their team
 > membership has given them.
-
-
-![Organization repository collaborators](images/org-repo-collaborators.png)