diff --git a/CHANGELOG.md b/CHANGELOG.md
index 895e38f46..db576f20b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,7 +1,7 @@
 Changelog
 =========
 
-[v2.21](https://github.com/rigetti/pyquil/compare/v2.20.0..master) (in development)
+[dev](https://github.com/rigetti/pyquil/compare/v2.20.0..master) (in development)
 ------------------------------------------------------------------------------------
 
 ### Announcements
@@ -11,6 +11,7 @@ Changelog
 -   Documentation for Compiler, Advanced Usage, and Troubleshooting sections updated
     (@notmgsk, gh-1220).
 -   Use numeric abstract base classes for type checking (@kilimanjaro, gh-1219).
+-   Add XY to docs (@notmgsk, gh-1226).
 
 ### Bugfixes
 
diff --git a/docs/source/apidocs/gates.rst b/docs/source/apidocs/gates.rst
index ff917c925..c75bec38c 100644
--- a/docs/source/apidocs/gates.rst
+++ b/docs/source/apidocs/gates.rst
@@ -16,12 +16,12 @@ can be created using the function documented in this section::
 Native gates for Rigetti QPUs
 -----------------------------
 
-Physical quantum processors can enact a subset of all named gates. Luckily,
-a small set of gates is universal for quantum computation, so all named gates
-can be enacted by suitable combinations of physically realizable gates. Rigetti's
-superconducting quantum processors can perform :py:func:`RX` with ``angle=+-pi/2`` or
-``angle=+-pi``, :py:func:`RZ` with an arbitrary angle, and :py:func:`CZ` interactions
-between neighboring qubits. Rigetti QPUs can natively measure in the computational (Z) basis.
+Physical quantum processors can enact a subset of all named gates. Luckily, a small set of gates is
+universal for quantum computation, so all named gates can be enacted by suitable combinations of
+physically realizable gates. Rigetti's superconducting quantum processors can perform :py:func:`RX`
+with ``angle=+-pi/2`` or ``angle=+-pi``, :py:func:`RZ` with an arbitrary angle, :py:func:`CZ` and
+parametric :py:func:`XY` interactions between neighboring qubits. Rigetti QPUs can natively measure
+in the computational (Z) basis.
 
 .. autosummary::
     :toctree: autogen
@@ -30,6 +30,7 @@ between neighboring qubits. Rigetti QPUs can natively measure in the computation
     RX
     RZ
     CZ
+    XY
     MEASURE
 
 
@@ -63,6 +64,7 @@ set (ISA). The full list of quantum gates and classical Quil instructions is enu
     :template: autosumm.rst
 
     CZ
+    XY
     CNOT
     CCNOT
     CPHASE00
diff --git a/docs/source/basics.rst b/docs/source/basics.rst
index 0763e5e2b..77a902ca7 100644
--- a/docs/source/basics.rst
+++ b/docs/source/basics.rst
@@ -106,7 +106,7 @@ The following gates methods come standard with Quil and ``gates.py``:
 
 -  Phase gates: ``PHASE(theta)``, ``S``, ``T``
 
--  Controlled phase gates: ``CZ``, ``CPHASE00(alpha)``,
+-  Controlled phase gates: ``CZ``, ``XY``, ``CPHASE00(alpha)``,
    ``CPHASE01(alpha)``, ``CPHASE10(alpha)``, ``CPHASE(alpha)``
 
 -  Cartesian rotation gates: ``RX(theta)``, ``RY(theta)``, ``RZ(theta)``
diff --git a/docs/source/compiler.rst b/docs/source/compiler.rst
index 31e6ff1fc..e064e0239 100644
--- a/docs/source/compiler.rst
+++ b/docs/source/compiler.rst
@@ -6,13 +6,15 @@ The Quil Compiler
 Expectations for Program Contents
 ---------------------------------
 
-The QPUs have much more limited natural gate sets than the standard gate set offered by pyQuil: on Rigetti QPUs, the
-gate operators are constrained to lie in ``RZ(θ)``, ``RX(k*π/2)``, and ``CZ``; and the
-gates are required to act on physically available hardware (for single-qubit gates, this means
-acting only on live qubits, and for qubit-pair gates, this means acting on neighboring qubits). However, as a programmer, it is often (though not always) desirable to to be able to write programs which don't take these details into account. This generally leads to more portable code if one isn't tied to a specific set of gates or QPU architecture.
-To ameliorate these limitations, the Rigetti software toolkit contains an optimizing compiler that
-translates arbitrary Quil to native Quil and native Quil to executables suitable for Rigetti
-hardware.
+The QPUs have much more limited natural gate sets than the standard gate set offered by pyQuil: on
+Rigetti QPUs, the gate operators are constrained to lie in ``RZ(θ)``, ``RX(k*π/2)``, ``CZ`` and
+``XY``; and the gates are required to act on physically available hardware (for single-qubit gates,
+this means acting only on live qubits, and for qubit-pair gates, this means acting on neighboring
+qubits). However, as a programmer, it is often (though not always) desirable to to be able to write
+programs which don't take these details into account. This generally leads to more portable code if
+one isn't tied to a specific set of gates or QPU architecture. To ameliorate these limitations, the
+Rigetti software toolkit contains an optimizing compiler that translates arbitrary Quil to native
+Quil and native Quil to executables suitable for Rigetti hardware.
 
 
 Interacting with the Compiler