simplify wording about editing diagrams

incorporate feedback from tech writers

README.md

@@ -45,25 +45,26 @@ In order to configure some aspects of layout, like the header, edit `config/tech
 If you move pages around and URLs change, make sure you set up redirects from the old URLs to the new URLs.
 
 ## Making changes to a diagram
-To make changes to a diagram, you'll need to edit the `drawio` files in `source/images/originals` using the draw.io desktop app.
+Edit the `drawio` files in `source/images/originals` using the draw.io desktop app.
 
 Use one drawio file per diagram.
 
 ### Install draw.io desktop app
-1. Install the draw.io desktop app using Homebrew with the following command: 
+1. Use the following commands so that you can use draw.io at the command line (this will alias the binary): 
 ```
 brew cask install drawio
 ```
-2. Alias the binary so that you can just type `draw.io` at the command line. Use the following command to do this:
+
 ```
 alias=draw.io='/Applications/draw.io.app/Contents/MacOS/draw.io'
 ```
 ### Edit and publish the diagram
 Follow these steps:
 1. Create and modify the diagram using [draw.io](https://about.draw.io/).
-1. Store the draw.io original file in `source/images/originals`.
-1. Publish the diagram as a [scalable vector graphic (SVG)](https://www.w3.org/Graphics/SVG/).
-1. Store the SVG in the `source/images` folder.
+2. Store the draw.io original file in `source/images/originals`.
+3. Publish the diagram as a [scalable vector graphic (SVG)](https://www.w3.org/Graphics/SVG/).
+4. Store the SVG in the `source/images` folder.
+
 ### Useful commands
 Update a diagram:
 ```
@@ -72,6 +73,7 @@ draw.io source/images/originals/top-level-technical-diagram.drawio
 Generate SVG versions of the diagrams:
 ```
 draw.io -x -o source/images/top-level-technical-diagram.svg source/images/originals/top-level-technical-diagram.drawio
+
 draw.io -x -o source/images/technical-flow-diagram.svg source/images/originals/technical-flow-diagram.drawio
 ```