diff --git a/opensource/ways/issues.md b/opensource/ways/issues.md
index 56250c4bf8..10fce4bfd6 100644
--- a/opensource/ways/issues.md
+++ b/opensource/ways/issues.md
@@ -20,7 +20,7 @@ think are important. Triage is a great choice if you have an interest
or experience in software product management or project management.
-# What kind of issues can I triage?
+## What kind of issues can I triage?
Docker users and contributors create new issues if they want to:
@@ -28,7 +28,7 @@ Docker users and contributors create new issues if they want to:
* request a new feature
* ask a question
-# How do I triage?
+## How do I triage?
Follow these steps:
@@ -36,56 +36,30 @@ Follow these steps:
2. Visit a Docker repository and press the **Watch** button.
-This tells GitHub to notify you of new issues. Depending on your settings,
-notification go to your GitHub or email inbox. Some of repositories you can watch are:
-
-
-
-
- docker/docker |
- Docker the open-source application container engine |
-
-
- docker/machine |
- Software for the easy and quick creation of Docker hosts on your computer, on cloud providers, and inside your own data center. |
-
-
- kitematic/kitematic |
- Kitematic is a simple application for managing Docker containers on macOS and Windows. |
-
-
- docker/swarm |
- Native clustering for Docker; manage several Docker hosts as a single, virtual host. |
-
-
- docker/compose |
- Define and run complex applications using one or many interlinked containers. |
-
-
+ This tells GitHub to notify you of new issues. Depending on your settings,
+ notification go to your GitHub or email inbox. Some of repositories you can watch are:
+
+ | Repository | Description |
+ | [docker/docker](https://github.com/docker/docker) | Docker the open-source application container engine |
+ | [docker/machine](https://github.com/docker/machine) | Software for the easy and quick creation of Docker hosts on your computer, on cloud providers, and inside your own data center. |
+ | [kitematic/kitematic](https://github.com/kitematic/kitematic) | Kitematic is a simple application for managing Docker containers on macOS and Windows. |
+ | [docker/swarm](https://github.com/docker/swarm) | Native clustering for Docker; manage several Docker hosts as a single, virtual host. |
+ | [docker/compose](ttps://github.com/docker/compose) | Define and run complex applications using one or many interlinked containers. |
+ See the complete list of Docker repositories on GitHub.
-See the complete list of
-Docker repositories on GitHub.
+3. Choose an issue from the [list of untriaged issues](https://github.com/docker/docker/issues?q=is%3Aopen+is%3Aissue+-label%3Akind%2Fproposal+-label%3Akind%2Fenhancement+-label%3Akind%2Fbug+-label%3Akind%2Fcleanup+-label%3Akind%2Fgraphics+-label%3Akind%2Fwriting+-label%3Akind%2Fsecurity+-label%3Akind%2Fquestion+-label%3Akind%2Fimprovement+-label%3Akind%2Ffeature).
-3. Choose an issue from the list of untriaged issues.
+4. Follow the the triage process to triage the issue.
-4. Follow the the triage process to triage the issue.
+ The triage process asks you to add both a `kind/` and a `exp/` label to each
+ issue. Because you are not a Docker maintainer, you add these through comments.
+ Simply add a `+label` keyword to an issue comment:
-The triage process asks you to add both a `kind/` and a `exp/` label to each
-issue. Because you are not a Docker maintainer, you add these through comments.
-Simply add a `+label` keyword to an issue comment:
+ 
-
-
-For example, the `+exp/beginner` and `+kind/writing` labels would triage an issue as
-beginner writing task. For descriptions of valid labels, see the the triage process
+ For example, the `+exp/beginner` and `+kind/writing` labels would triage an issue as
+ beginner writing task. For descriptions of valid labels, see the the triage process
5. Triage another issue.