diff --git a/doc/spec/api.md b/doc/spec/api.md
index 46017c7ab..8b1c38b7b 100644
--- a/doc/spec/api.md
+++ b/doc/spec/api.md
@@ -19,9 +19,9 @@ reduce bandwidth usage and decrease the likelihood of backend corruption.
 For relevant details and history leading up to this specification, please see
 the following issues:
 
-- docker/docker#8093
-- docker/docker#9015
-- docker/docker-registry#612
+- [docker/docker#8093](https://github.com/docker/docker/issues/8903)
+- [docker/docker#9015](https://github.com/docker/docker/issues/9015)
+- [docker/docker-registry#612](https://github.com/docker/docker-registry/issues/612)
 
 ### Scope