edit text

Author: Katie Horne

workspaces/variables.md

@@ -89,9 +89,9 @@ env | grep CODER_
 
 Coder uses the following environment variables for its internal operation:
 
-> **Important**: These may be modified or removed in future releases without
-> prior notice, and are not covered by Coder's backward compatibility policy.
-> These are documented here for your information only.
+> **Important**: These variables may be modified or removed in future releases
+> without prior notice and are not covered by Coder's backward compatibility
+> policy. These are documented here for your information only.
 
 <!-- markdownlint-disable MD044 -->
 <table>
@@ -103,26 +103,25 @@ Coder uses the following environment variables for its internal operation:
         <td><code>CODER_AGENT_TOKEN</code></td>
         <td>The token used by the <a href="../setup/architecture.md">Coder Agent</a>
             to authenticate with <code>coderd</code>. The Coder Agent handles
-            tunnelled connections, collection of workspace statistics (such as
+            tunnelled connections, collects workspace statistics (such as
             processor and memory utilization), and manages programs, such as
             editors.</td>
     </tr>
     <tr>
         <td><code>CODER_AGENT_URL</code></td>
-        <td>This is the URL that the <code>coder agent</code> process will use
+        <td>Th URL that the <code>coder agent</code> process uses
             to connect to <code>coderd</code>. If this is not set, the agent
-            will connect to <code>CODER_URL</code> instead. This enables the
+            will connect to <code>CODER_URL</code> instead, enabling the
             <code>coder agent</code> and <code>coder</code> command-line tool
             to connect to different installations.</td>
     </tr>
     <tr>
         <td><code>CODER_BOOTSTRAP_SCRIPT</code></td>
-        <td>When the
+        <td>The script used to initiate the workspace startup sequence when the
             <a href="../admin/workspace-management/self-contained-builds.md">
-            self-contained workspace builds</a> feature is active, this variable
-            will contain a small script used to initiate the workspace startup
-            sequence, beginning by downloading the "bootstrap agent" from the
-            <code>coderd</code> process.</td>
+            self-contained workspace builds</a> feature is active; begins by
+             downloading the "bootstrap agent" from the <code>coderd</code>
+             process.</td>
     </tr>
 </table>
 <!-- markdownlint-restore -->