Skip to content
This repository was archived by the owner on Aug 18, 2025. It is now read-only.

Commit fdaf11a

Browse files
author
Katie Horne
committed
apply changes
1 parent b27b43c commit fdaf11a

File tree

1 file changed

+9
-5
lines changed

1 file changed

+9
-5
lines changed

guides/workspaces.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,10 @@ individual developer to manage. However, the complexity of the underlying images
1111
increases as the images need to support multiple projects, each potentially with
1212
its 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

1620
With 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
6569
you to change the underlying image, so you can update the image (changing out
6670
the 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

Comments
 (0)