diff --git a/docs/instruments.rst b/docs/instruments.rst
index 815eb81b8..5165433b1 100644
--- a/docs/instruments.rst
+++ b/docs/instruments.rst
@@ -5,7 +5,8 @@ instruments
     :summary: Show how to craft instruments or create work orders for them.
     :tags: fort inspection workorders
 
-This tool is used to query information about instruments or to create work orders for them.
+This tool is used to query information about instruments or to create work
+orders to produce them.
 
 The ``list`` subcommand provides information on how to craft the instruments
 used by the player civilization. For single-piece instruments, it shows the
@@ -15,7 +16,7 @@ necessary pieces. It also shows whether the instrument is handheld or placed as
 a building.
 
 The ``order`` subcommand is used to create work orders for an instrument and
-all of it's parts. The final assemble instrument -order waits for the part
+all of it's parts. The final assemble instrument order waits for the part
 orders to complete before starting.
 
 Usage
@@ -38,10 +39,9 @@ Examples
     If the instrument named ``givel`` in your world has four components, this
     will create a total of 5 work orders: one for assembling 10 givels, and an
     order of 10 for each of the givel's parts. Instruments are randomly
-    generated, so your givel components may vary.
-
+    generated, so your instrument names and components will vary.
 ``instruments order ilul``
-    Creates work orders to assemble one ïlul. Spelling doesn't need to include
+    Creates work orders to assemble one ïlul. Spelling does not need to include
     the special ï character.
 
 Options