diff --git a/docs/changelog.txt b/docs/changelog.txt
index 7bb4bd9c7..ed3ab4f02 100644
--- a/docs/changelog.txt
+++ b/docs/changelog.txt
@@ -44,10 +44,10 @@ changelog.txt uses a syntax similar to RST, with a few special sequences:
 - UX: List widgets now have mouse-interactive scrollbars
 - UX: You can now hold down the mouse button on a scrollbar to make it scroll multiple times.
 - UX: You can now drag the scrollbar to scroll to a specific spot
-- `spectate`: ``spectate auto-unpause`` is a new feature that will auto-dismiss pause events when enabled. This does not affect the player's ability to pause at a whim.
-- `spectate`: ``spectate auto-disengage`` is a new feature that will auto-disengage the plugin when the player interacts with the game while unpaused
-- `spectate`: ``spectate focus-jobs`` is a new feature that allows the plugin to not always follow a job, so it can trail a dwarf after they finish a job
-- `spectate`: ``spectate tick-threshold`` is a new feature that allows the player to change how long to follow a dwarf
+- `spectate`: new ``auto-unpause`` option for auto-dismissal of announcement pause events (e.g. sieges).
+- `spectate`: new ``auto-disengage`` option for auto-disengagement of plugin through player interaction whilst unpaused.
+- `spectate`: new ``focus-jobs`` option for following a dwarf after their job has finished (when disabled).
+- `spectate`: new ``tick-threshold``, option for specifying the change interval (maximum follow time when focus-jobs is enabled)
 - `spectate`: added persistent configuration of the plugin settings
 
 ## Documentation