diff --git a/demos/rest/readme.md b/demos/rest/readme.md
index 304360cab..d4980244a 100644
--- a/demos/rest/readme.md
+++ b/demos/rest/readme.md
@@ -1 +1,13 @@
-Readme
+This  demo shows interacting with the Github API via Invoke-RestMethod.
+NOTE: A repo URL must be specified in these scripts and a Github PAT token with access to the repo must be generated and specified
+
+rest.ps1 
+Invoke-RestMethod is used to get the json of a repo as a PowerShell object,
+the object is then manipulated and the "private" parameter is changed to 'false'.
+The object is converted back to json formating and Posted back to the repo API
+
+The benefit of PS is shown at the end of the script with PS objects.
+Enabling users to get info on multiple repos and then sort that data as objects.
+
+curlDemo.txt
+This shos the equavilent bash commmands to change the private status of a Github repo