@@ -11,6 +11,10 @@ individual developer to manage. However, the complexity of the underlying images
1111increases as the images need to support multiple projects, each potentially with
1212its own language, set of tooling, and dependencies.
1313
14+ Nevertheless, for teams that do not have a complex development workflow, we
15+ recommend starting with one workspace per developer, since it is the fastest,
16+ most straightforward model to adopt.
17+
1418## One workspace per developer
1519
1620With one workspace per developer, you can think of the Coder workspace the way
@@ -23,7 +27,7 @@ Benefits:
2327- Fewer workspaces to manage
2428- No need to switch between workspaces for different projects
2529
26- Limitations :
30+ Potential caveats :
2731
2832- The size of the workspace can grow quite large
2933- The image supporting such a workspace can become complex
@@ -37,7 +41,7 @@ Benefits:
3741
3842- Smaller images, since they only contain one language and its dependencies
3943
40- Limitations :
44+ Potential caveats :
4145
4246- Developers may have multiple workspaces, consuming more storage space overall
4347
@@ -52,7 +56,7 @@ Benefits:
5256- Streamlined images with only the languages and dependencies included
5357- Smaller, lighter workspaces
5458
55- Limitations :
59+ Potential caveats :
5660
5761- As the number of workspaces per developer grows, the importance of
5862 well-defined dotfiles grow to ensure that developers do not spend too much
@@ -65,8 +69,8 @@ A subset of this category is one workspace per **major** version of a project
6569you to change the underlying image, so you can update the image (changing out
6670the language and any dependencies) if needed.
6771
68- The benefits and limitations of this option are similar to those involved with
69- setting up one workspace per project per developer.
72+ The benefits and potential caveats of this option are similar to those involved
73+ with setting up one workspace per project per developer.
7074
7175## One workspace per feature/branch
7276
0 commit comments