diff --git a/taskflow/states.py b/taskflow/states.py
index 26ff18a0..74b056c2 100644
--- a/taskflow/states.py
+++ b/taskflow/states.py
@@ -53,7 +53,7 @@ TIMED_OUT = 'TIMED_OUT'
 
 
 ## Flow state transitions
-# https://wiki.openstack.org/wiki/TaskFlow/States_of_Task_and_Flow#Flow_States
+# See: http://docs.openstack.org/developer/taskflow/states.html
 
 _ALLOWED_FLOW_TRANSITIONS = frozenset((
     (PENDING, RUNNING),       # run it!
@@ -124,7 +124,7 @@ def check_flow_transition(old_state, new_state):
 
 
 ## Task state transitions
-# https://wiki.openstack.org/wiki/TaskFlow/States_of_Task_and_Flow#Task_States
+# See: http://docs.openstack.org/developer/taskflow/states.html
 
 _ALLOWED_TASK_TRANSITIONS = frozenset((
     (PENDING, RUNNING),       # run it!