Sharing-apps-in-OOD.md

 
 ### 1. Apps now have icons and categories
 
-1\. Icons: In the root of the app, add an icon that is 100x100 in size called `icon.png`. It must be png format. You can use image magick (installed on Oakley login nodes) to convert the image to the desired format (i.e. `convert my.jpg icon.png`).
+#### A. Icons: 
+
+In the root of the app, add an icon that is 100x100 in size called `icon.png`. It must be png format. You can use image magick (installed on Oakley login nodes) to convert the image to the desired format (i.e. `convert my.jpg icon.png`).
 
 Example of an app without an icon:
 
@@ -12,7 +14,9 @@ Example of an app with an icon:
 * ![With Icon](./images/ood/icon2.png)
 
 
-2\. Categories: in the manifest, if you specify `category: My Category` the app will display in a section grouped with other apps that specify the same category.
+#### B. Categories: 
+
+in the manifest, if you specify `category: My Category` the app will display in a section grouped with other apps that specify the same category.
 
 Here is the Active Jobs app with no category specified:
 
@@ -23,7 +27,7 @@ Here I changed the category in the manifest to OSC (`category: OSC`):
 * ![With Category](./images/ood/cat2_osc.png)
 
 
-3\. Manifest documentation field is now ignored
+#### C. Manifest documentation field is now ignored
 
 We only display the description field to the user. Share documentation in the app. If necessary, direct users to documentation outside of the app by adding links to the description field.
 
@@ -57,7 +61,10 @@ Run after changing shared app.
 
 You can do this through the web interface:
 
-* TODO
+![Update app](./images/ood/update_app.png)
+
+* click "Bundle Install" & "Build Assets" & "Restart App" or just "Update App" (there will be one button to replace this in the future)
+
 
 Or you can do this via the command line by running this bash script in the app root folder: