diff --git a/docs/docsite/rst/porting_guide_2.5.rst b/docs/docsite/rst/porting_guide_2.5.rst
new file mode 100644
index 0000000000..d6391c4c99
--- /dev/null
+++ b/docs/docsite/rst/porting_guide_2.5.rst
@@ -0,0 +1,67 @@
+.. _porting_2.5_guide:
+
+*************************
+Ansible 2.5 Porting Guide
+*************************
+
+This section discusses the behavioral changes between Ansible 2.4 and Ansible 2.5.
+
+It is intended to assist in updating your playbooks, plugins and other parts of your Ansible infrastructure so they will work with this version of Ansible.
+
+We suggest you read this page along with `Ansible Changelog <https://github.com/ansible/ansible/blob/devel/CHANGELOG.md#2.5>`_ to understand what updates you may need to make.
+
+This document is part of a collection on porting. The complete list of porting guides can be found at :ref:`porting guides <porting_guides>`.
+
+.. contents:: Topics
+
+Playbook
+========
+
+No notable changes.
+
+Deprecated
+==========
+
+No notable changes.
+
+Modules
+=======
+
+Major changes in popular modules are detailed here
+
+No notable changes.
+
+Modules removed
+---------------
+
+The following modules no longer exist:
+
+* None
+
+Deprecation notices
+-------------------
+
+The following modules will be removed in Ansible 2.8. Please update update your playbooks accordingly.
+
+* :ref:`fixme <fixme>`
+
+Noteworthy module changes
+-------------------------
+
+No notable changes.
+
+Plugins
+=======
+
+No notable changes.
+
+Porting custom scripts
+======================
+
+No notable changes.
+
+Networking
+==========
+
+No notable changes.
+
diff --git a/docs/docsite/rst/porting_guides.rst b/docs/docsite/rst/porting_guides.rst
index 4c1dbec5fd..8e09c82a2f 100644
--- a/docs/docsite/rst/porting_guides.rst
+++ b/docs/docsite/rst/porting_guides.rst
@@ -10,3 +10,4 @@ This section lists porting guides that can help you playbooks, plugins and other
 * :ref:`Ansible 1.x to 2.0 porting guide <porting_2.0_guide>`
 * :ref:`Ansible 2.2 to 2.3 porting guide <porting_2.3_guide>`
 * :ref:`Ansible 2.3 to 2.4 porting guide <porting_2.4_guide>`
+* :ref:`Ansible 2.4 to 2.5 porting guide <porting_2.5_guide>`