Documentation updates

Co-authored-by: Daniel J. Egger <[email protected]>
Qiskit · Oct 24, 2022 · 7ab2710 · 7ab2710
1 parent 1f1db8d
commit 7ab2710
Show file tree

Hide file tree

Showing 2 changed files with 8 additions and 4 deletions.
diff --git a/qiskit/pulse/instructions/directives.py b/qiskit/pulse/instructions/directives.py
@@ -61,9 +61,9 @@ class TimeBlockade(Directive):
     """Pulse ``TimeBlockade`` directive.
 
     This instruction is intended to be used internally within the pulse builder,
-    to naively convert :class:`.Schedule` into :class:`.ScheduleBlock`.
-    Because :class:`.ScheduleBlock` cannot take absolute instruction time interval,
-    this instruction helps the block representation with finding instruction starting time.
+    to convert :class:`.Schedule` into :class:`.ScheduleBlock`.
+    Because :class:`.ScheduleBlock` cannot take an absolute instruction time interval,
+    this directive helps the block representation to find the starting time of an instruction.
 
     Example:
 

diff --git a/releasenotes/notes/upgrade-pulse-builder-and-rzx-builder-033ac8ad8ad2a192.yaml b/releasenotes/notes/upgrade-pulse-builder-and-rzx-builder-033ac8ad8ad2a192.yaml
@@ -17,7 +17,11 @@ upgrade:
     :class:`.ScheduleBlock` representation and now reference mechanism is
     always applied rather than appending the schedules wrapped by
     the :class:`~qiskit.pulse.instructions.Call` instruction.
-    This is an upgrade of internal representation and thus no API changes.
+    Note that the converted block doesn't necessary recover the original alignment context.
+    This is simply an ASAP aligned sequence of pulse instructions with absolute time intervals.
+    This is an upgrade of internal representation of called pulse programs and thus no API changes.
+    However the :class:`~qiskit.pulse.instructions.Call` instruction and :class:`.Schedule`
+    no longer appear in the builder's pulse program.
     This change guarantees the generated schedule blocks are always QPY compatible.
   - |
     :class:`~qiskit.transpiler.passes.RZXCalibrationBuilder`