diff --git a/keystone/contrib/admin_crud/core.py b/keystone/contrib/admin_crud/core.py
index 5d69d2490c..de07815de9 100644
--- a/keystone/contrib/admin_crud/core.py
+++ b/keystone/contrib/admin_crud/core.py
@@ -32,10 +32,9 @@ extension.register_admin_extension(
         'links': [
             {
                 'rel': 'describedby',
-                # TODO(dolph): link needs to be revised after
-                #              bug 928059 merges
                 'type': 'text/html',
-                'href': 'https://github.com/openstack/identity-api',
+                'href': 'http://developer.openstack.org/'
+                        'api-ref-identity-v2-ext.html',
             }
         ]})
 
diff --git a/keystone/contrib/ec2/core.py b/keystone/contrib/ec2/core.py
index 210254f803..7bba8cab95 100644
--- a/keystone/contrib/ec2/core.py
+++ b/keystone/contrib/ec2/core.py
@@ -26,7 +26,8 @@ EXTENSION_DATA = {
         {
             'rel': 'describedby',
             'type': 'text/html',
-            'href': 'https://github.com/openstack/identity-api',
+            'href': 'http://developer.openstack.org/'
+                    'api-ref-identity-v2-ext.html',
         }
     ]}
 extension.register_admin_extension(EXTENSION_DATA['alias'], EXTENSION_DATA)
diff --git a/keystone/contrib/s3/core.py b/keystone/contrib/s3/core.py
index 4645d3b302..c497f5d55f 100644
--- a/keystone/contrib/s3/core.py
+++ b/keystone/contrib/s3/core.py
@@ -47,7 +47,8 @@ EXTENSION_DATA = {
         {
             'rel': 'describedby',
             'type': 'text/html',
-            'href': 'https://github.com/openstack/identity-api',
+            'href': 'http://developer.openstack.org/'
+                    'api-ref-identity-v2-ext.html',
         }
     ]}
 extension.register_admin_extension(EXTENSION_DATA['alias'], EXTENSION_DATA)
diff --git a/keystone/contrib/simple_cert/core.py b/keystone/contrib/simple_cert/core.py
index 531c6aae11..ec7b8f0402 100644
--- a/keystone/contrib/simple_cert/core.py
+++ b/keystone/contrib/simple_cert/core.py
@@ -22,10 +22,9 @@ EXTENSION_DATA = {
     'links': [
         {
             'rel': 'describedby',
-            # TODO(dolph): link needs to be revised after
-            #              bug 928059 merges
             'type': 'text/html',
-            'href': 'https://github.com/openstack/identity-api',
+            'href': 'http://developer.openstack.org/'
+                    'api-ref-identity-v2-ext.html',
         }
     ]}
 extension.register_admin_extension(EXTENSION_DATA['alias'], EXTENSION_DATA)
diff --git a/keystone/contrib/user_crud/core.py b/keystone/contrib/user_crud/core.py
index e85e96f134..8011703b66 100644
--- a/keystone/contrib/user_crud/core.py
+++ b/keystone/contrib/user_crud/core.py
@@ -41,7 +41,8 @@ extension.register_public_extension(
             {
                 'rel': 'describedby',
                 'type': 'text/html',
-                'href': 'https://github.com/openstack/identity-api',
+                'href': 'http://developer.openstack.org/'
+                        'api-ref-identity-v2-ext.html',
             }
         ]})
 
diff --git a/keystone/federation/core.py b/keystone/federation/core.py
index ef5d50799e..3fc1244065 100644
--- a/keystone/federation/core.py
+++ b/keystone/federation/core.py
@@ -37,7 +37,8 @@ EXTENSION_DATA = {
     'links': [{
         'rel': 'describedby',
         'type': 'text/html',
-        'href': 'https://github.com/openstack/identity-api'
+        'href': 'http://specs.openstack.org/openstack/keystone-specs/api/v3/'
+                'identity-api-v3-os-federation-ext.html',
     }]}
 extension.register_admin_extension(EXTENSION_DATA['alias'], EXTENSION_DATA)
 extension.register_public_extension(EXTENSION_DATA['alias'], EXTENSION_DATA)
diff --git a/keystone/oauth1/core.py b/keystone/oauth1/core.py
index 6406a8036e..4e090472f1 100644
--- a/keystone/oauth1/core.py
+++ b/keystone/oauth1/core.py
@@ -77,10 +77,9 @@ EXTENSION_DATA = {
     'links': [
         {
             'rel': 'describedby',
-            # TODO(dolph): link needs to be revised after
-            #              bug 928059 merges
             'type': 'text/html',
-            'href': 'https://github.com/openstack/identity-api',
+            'href': 'http://specs.openstack.org/openstack/keystone-specs/api/'
+                    'v3/identity-api-v3-os-oauth1-ext.html',
         }
     ]}
 extension.register_admin_extension(EXTENSION_DATA['alias'], EXTENSION_DATA)
diff --git a/keystone/revoke/core.py b/keystone/revoke/core.py
index 602e13d184..d9b3df36c8 100644
--- a/keystone/revoke/core.py
+++ b/keystone/revoke/core.py
@@ -46,9 +46,8 @@ EXTENSION_DATA = {
         {
             'rel': 'describedby',
             'type': 'text/html',
-            'href': ('https://github.com/openstack/identity-api/blob/master/'
-                     'openstack-identity-api/v3/src/markdown/'
-                     'identity-api-v3-os-revoke-ext.md'),
+            'href': 'http://specs.openstack.org/openstack/keystone-specs/api/'
+                    'v3/identity-api-v3-os-revoke-ext.html',
         }
     ]}
 extension.register_admin_extension(EXTENSION_DATA['alias'], EXTENSION_DATA)