Skip to content

docs: improve README structure with Docker-first quick start - #132

Merged
avoidwork merged 2 commits into
mainfrom
docs/improve-readme-structure-and-docker-first
Jun 7, 2026
Merged

docs: improve README structure with Docker-first quick start#132
avoidwork merged 2 commits into
mainfrom
docs/improve-readme-structure-and-docker-first

Conversation

@avoidwork

Copy link
Copy Markdown
Owner

Description

Restructure the README to present Docker as the recommended deployment path. Add a Docker Quick Start section in Quick Start with a minimal docker run command, reference Docker for the full command with all optional environment variables, and point readers to the Config Reference table for all configuration options. Reorder the Docker Running section so pulling the prebuilt image is the primary path. Also fix a trailing double period in the Docker SSH section and a YAML indentation error in the skill frontmatter example.

Type of Change

  • Bugfix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Documentation update
  • Refactor (no functional changes)
  • Performance improvement
  • CI / build / tooling

Testing

N/A - documentation-only change.

Coverage

  • 100% line coverage maintained

Checklist

  • `npm run lint` passes
  • Tests pass with 100% line coverage
  • No forbidden patterns used
  • Conventional Commit style applied

avoidwork added 2 commits June 7, 2026 13:43
…typos

- Add Docker recommendation callout after tagline
- Add Docker Quick Start section with minimal docker run command
- Replace minimal config.yaml snippet with Docker reference and pointer to Config Reference
- Reorder Docker Running section to show pull before build as primary path
- Fix trailing double period in Docker SSH section
- Fix YAML indentation in skill frontmatter example
- Use /tmp instead of tmp/ (absolute path, no trailing slash)
- Remove ./ from sandbox paths
- Move /tmp to the end of the paths list
- Change memoryLimit from 512m to 128mb
- Change maxReadSize from 1mb to 10mb
@avoidwork avoidwork self-assigned this Jun 7, 2026
@avoidwork
avoidwork enabled auto-merge (squash) June 7, 2026 17:49
@avoidwork
avoidwork merged commit bc90e52 into main Jun 7, 2026
2 checks passed
@avoidwork
avoidwork deleted the docs/improve-readme-structure-and-docker-first branch June 7, 2026 17:50
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