Skip to content

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

Merged
eywalker merged 1 commit into
nauticalab:mainfrom
spapa013:spapadop/plt-858-bring-readme-devenv-setup-instructions-up-to-a-complete-and
Jun 18, 2026
Merged

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

Conversation

@spapa013

Copy link
Copy Markdown
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

codecov Bot commented Mar 19, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@eywalker
eywalker merged commit ee23140 into nauticalab:main Jun 18, 2026
2 checks passed
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.

2 participants