diff --git a/codespaces/README.md b/codespaces/README.md
index d34f6da..693c733 100644
--- a/codespaces/README.md
+++ b/codespaces/README.md
@@ -1,15 +1,14 @@
 # Codespaces
 
+## New to codespaces?
+* [Start here](https://docs.github.com/en/codespaces). Learn the core concepts and how to get started.
+* [Quickstart for GitHub Codespaces](https://docs.github.com/en/codespaces/getting-started/quickstart).
 
-
-## Creating for the first time
-
-### Create codespaces  
+## Create codespaces  
 1. Select branch
 2. Go to Code> create codespace on `branch-name` 
 3. `New with options`
 
-
 ## predefined dev container configuration
 
 1. Access the Visual Studio Code Command Palette (Shift+Command+P / Ctrl+Shift+P), then start typing "add dev".