diff --git a/.github/codespaces-readme.md b/.github/codespaces-readme.md
index 48dbe16b0a..b71a6b5284 100644
--- a/.github/codespaces-readme.md
+++ b/.github/codespaces-readme.md
@@ -1,2 +1,21 @@
 # GitHub CodeSpaces
-Get help at hackathon with this readme to list out steps or specific useful info to get up and running 
\ No newline at end of file
+Umbraco source code can be edited inside the browser with VSCode and CodeSpaces.
+
+This development environment comes with all the tools you need to build Umbraco source code.
+
+
+## Debugging and Running
+From VSCode browse to the Run and Debug section and then click the green button. This will build the Umbraco source code and attach a debugger and launch the site.
+
+## Default Umbraco credentials
+Username: test@umbraco.com
+Password: password1234
+
+## Test Email Server
+ A SMTP4Dev instance for testing email is available on port 5000.
+
+## SQLite Database
+The SQLite extension is preinstalled and allows you to open, query, edit the data inside the Umbraco SQLite database for ease of use.
+
+
+