Skip to content

Rewrite README with accurate end-to-end setup guide#39

Open
spapa013 wants to merge 1 commit intonauticalab:mainfrom
spapa013:spapadop/plt-858-bring-readme-devenv-setup-instructions-up-to-a-complete-and
Open

Rewrite README with accurate end-to-end setup guide#39
spapa013 wants to merge 1 commit intonauticalab:mainfrom
spapa013:spapadop/plt-858-bring-readme-devenv-setup-instructions-up-to-a-complete-and

Conversation

@spapa013
Copy link
Collaborator

The previous README was significantly incomplete and contained inaccuracies that would block a new user from getting started.

  • Rewrote overview to capture the purpose of DevEnv (personal, persistent, SSH-accessible Linux environments in Kubernetes)
  • Fixed build instructions: make → task
  • Documented required directory structure and config file layout
  • Added annotated YAML examples for both config files
  • Added step-by-step workflow from directory setup through kubectl apply
  • Added CLI reference with all flags (including --no-cleanup which will be added in an upcoming PR)
  • Added Field Glossary split by config file, with required/optional column, defaults, and additive merge behavior noted per field

Closes PLT-858

The previous README was significantly incomplete and contained
inaccuracies that would block a new user from getting started.

- Rewrote overview to capture the purpose of DevEnv (personal,
  persistent, SSH-accessible Linux environments in Kubernetes)
- Fixed build instructions: make → task
- Documented required directory structure and config file layout
- Added annotated YAML examples for both config files
- Added step-by-step workflow from directory setup through kubectl apply
- Added CLI reference with all flags (including --no-cleanup which will be added in an upcoming PR)
- Added Field Glossary split by config file, with required/optional  column, defaults, and additive merge behavior noted per field
@spapa013 spapa013 requested a review from eywalker March 19, 2026 22:13
@codecov
Copy link

codecov bot commented Mar 19, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant