diff --git a/README.md b/README.md
index 92aad84cbc..e86982fce1 100644
--- a/README.md
+++ b/README.md
@@ -305,13 +305,13 @@ Global Options:
       --no-progress    Hide all progress bars, always turned on if stderr is not a terminal [env: PIXI_NO_PROGRESS=]
 ```
 
-## Creating a Pixi project
+## Creating a Pixi workspace
 
-Initialize a new project and navigate to the project directory
+Initialize a new workspace and navigate to the workspace directory
 
 ```
-pixi init myproject
-cd myproject
+pixi init myworkspace
+cd myworkspace
 ```
 
 Add the dependencies you want to use
@@ -334,6 +334,8 @@ cowpy "Thanks for using pixi"
 exit
 ```
 
+Check out https://pixi.sh/dev/first_workspace/ for a more detailed introduction to workspaces.
+
 ## Installing a conda package globally
 
 You can also globally install conda packages into their own environment.