diff --git a/README.rst b/README.rst
index 1d4a335a4..7722a1e27 100644
--- a/README.rst
+++ b/README.rst
@@ -23,9 +23,9 @@ and declarative manner (and more!) to be used with OpenStack and other
 projects.
 
 * Free software: Apache license
-* Documentation: http://docs.openstack.org/developer/taskflow
-* Source: http://git.openstack.org/cgit/openstack/taskflow
-* Bugs: http://bugs.launchpad.net/taskflow/
+* Documentation: https://docs.openstack.org/taskflow/latest/
+* Source: https://git.openstack.org/cgit/openstack/taskflow
+* Bugs: https://bugs.launchpad.net/taskflow/
 
 Join us
 -------
@@ -74,4 +74,4 @@ We also have sphinx documentation in ``docs/source``.
 .. _kombu: http://kombu.readthedocs.org/
 .. _eventlet: http://eventlet.net/
 .. _tox: http://tox.testrun.org/
-.. _developer documentation: http://docs.openstack.org/developer/taskflow/
+.. _developer documentation: https://docs.openstack.org/taskflow/latest/
diff --git a/doc/source/user/engines.rst b/doc/source/user/engines.rst
index aef0c0dae..4362b9a12 100644
--- a/doc/source/user/engines.rst
+++ b/doc/source/user/engines.rst
@@ -466,7 +466,7 @@ Hierarchy
     taskflow.engines.worker_based.engine.WorkerBasedActionEngine
     :parts: 1
 
-.. _automaton: http://docs.openstack.org/developer/automaton/
+.. _automaton: https://docs.openstack.org/automaton/latest/
 .. _multiprocessing: https://docs.python.org/2/library/multiprocessing.html
 .. _future: https://docs.python.org/dev/library/concurrent.futures.html#future-objects
 .. _executor: https://docs.python.org/dev/library/concurrent.futures.html#concurrent.futures.Executor
diff --git a/doc/source/user/jobs.rst b/doc/source/user/jobs.rst
index c3a1f08ed..6a4dc2d2d 100644
--- a/doc/source/user/jobs.rst
+++ b/doc/source/user/jobs.rst
@@ -368,5 +368,5 @@ Hierarchy
 .. _paradigm shift: https://wiki.openstack.org/wiki/TaskFlow/Paradigm_shifts#Workflow_ownership_transfer
 .. _zookeeper: http://zookeeper.apache.org/
 .. _kazoo: http://kazoo.readthedocs.org/
-.. _stevedore: http://docs.openstack.org/developer/stevedore/
+.. _stevedore: https://docs.openstack.org/stevedore/latest
 .. _redis: http://redis.io/
diff --git a/doc/source/user/persistence.rst b/doc/source/user/persistence.rst
index 905ff7463..0f8dc93b5 100644
--- a/doc/source/user/persistence.rst
+++ b/doc/source/user/persistence.rst
@@ -31,7 +31,7 @@ This abstraction serves the following *major* purposes:
   vs. stop.
 * *Something you create...*
 
-.. _stevedore: http://docs.openstack.org/developer/stevedore/
+.. _stevedore: https://docs.openstack.org/stevedore/latest/
 
 How it is used
 ==============
diff --git a/setup.cfg b/setup.cfg
index 1f90a9e76..8b09d885c 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -5,7 +5,7 @@ description-file =
     README.rst
 author = OpenStack
 author-email = openstack-dev@lists.openstack.org
-home-page = http://docs.openstack.org/developer/taskflow
+home-page = https://docs.openstack.org/taskflow/latest/
 keywords = reliable,tasks,execution,parallel,dataflow,workflows,distributed
 classifier =
     Development Status :: 4 - Beta
diff --git a/taskflow/states.py b/taskflow/states.py
index aef7a231f..897d03d2e 100644
--- a/taskflow/states.py
+++ b/taskflow/states.py
@@ -56,7 +56,7 @@ WAITING = 'WAITING'
 ANALYZING = 'ANALYZING'
 
 # Job state transitions
-# See: http://docs.openstack.org/developer/taskflow/states.html
+# See: https://docs.openstack.org/taskflow/latest/user/states.html
 
 _ALLOWED_JOB_TRANSITIONS = frozenset((
     # Job is being claimed.
@@ -87,7 +87,7 @@ def check_job_transition(old_state, new_state):
 
 
 # Flow state transitions
-# See: http://docs.openstack.org/developer/taskflow/states.html#flow
+# See: https://docs.openstack.org/taskflow/latest/user/states.html#flow
 
 _ALLOWED_FLOW_TRANSITIONS = frozenset((
     (PENDING, RUNNING),       # run it!
@@ -159,7 +159,7 @@ def check_flow_transition(old_state, new_state):
 
 
 # Task state transitions
-# See: http://docs.openstack.org/developer/taskflow/states.html#task
+# See: https://docs.openstack.org/taskflow/latest/user/states.html#task
 
 _ALLOWED_TASK_TRANSITIONS = frozenset((
     (PENDING, RUNNING),       # run it!
@@ -191,7 +191,7 @@ def check_task_transition(old_state, new_state):
 
 
 # Retry state transitions
-# See: http://docs.openstack.org/developer/taskflow/states.html#retry
+# See: https://docs.openstack.org/taskflow/latest/user/states.html#retry
 
 _ALLOWED_RETRY_TRANSITIONS = list(_ALLOWED_TASK_TRANSITIONS)
 _ALLOWED_RETRY_TRANSITIONS.extend([
diff --git a/taskflow/tests/unit/test_engines.py b/taskflow/tests/unit/test_engines.py
index 89a1a4971..81f0e0842 100644
--- a/taskflow/tests/unit/test_engines.py
+++ b/taskflow/tests/unit/test_engines.py
@@ -234,7 +234,7 @@ class EngineMultipleResultsTest(utils.EngineTestBase):
     def test_many_results_storage_provided_visible_to(self):
         # This works as expected due to docs listed at
         #
-        # http://docs.openstack.org/developer/taskflow/engines.html#scoping
+        # https://docs.openstack.org/taskflow/latest/user/engines.html#scoping
         flow = lf.Flow("flow")
         flow.add(utils.AddOneSameProvidesRequires('a'))
         flow.add(utils.AddOneSameProvidesRequires('b'))