Skip to content

docs: rewrite getting started pages for a better first 5 minutes#3008

Open
bartlomieju wants to merge 1 commit intomainfrom
docs/improve-getting-started
Open

docs: rewrite getting started pages for a better first 5 minutes#3008
bartlomieju wants to merge 1 commit intomainfrom
docs/improve-getting-started

Conversation

@bartlomieju
Copy link
Copy Markdown
Member

Summary

Rewrites all five "Getting Started" pages to be more code-first and action-oriented, inspired by feedback comparing Deno's onboarding experience to Bun's.

  • Welcome page: leads with a runnable HTTP server example, shows all CLI tools upfront, adds "No package.json, no build step, no node_modules" hook
  • First project: replaces add(2, 3) with a progressive tutorial: init → HTTP server → routing → add zod from npm → write and run tests
  • Installation: streamlines to 1-2 recommended methods per OS, collapses niche options (MacPorts, asdf, vfox, cargo), adds inline Docker usage with a Dockerfile example
  • CLI overview: trims to essentials (run, permissions, arguments, watch mode), replaces plain text table with a linked subcommands table
  • Environment setup: leads with VS Code + JetBrains, collapses all other editors into expandable sections, adds --dynamic completions flag for deno task

Net result: -689 lines, +448 lines across 5 files.

Test plan

  • Verify all pages render correctly locally (deno task dev)
  • Check internal cross-links resolve (CLI reference pages, fundamentals pages)
  • Walk through the first project tutorial end-to-end
  • Confirm collapsible <details> sections work for editors and install methods
  • Verify the Docker table and Dockerfile example render properly

🤖 Generated with Claude Code

- Welcome page: add code examples, show what Deno can do upfront,
  tighten "Why Deno?" bullets with cross-links
- First project: replace add(2,3) with HTTP server tutorial that
  progressively adds routing, an npm dependency (zod), and tests
- Installation: streamline to recommended methods per OS, collapse
  niche options, add inline Docker usage with Dockerfile example
- CLI: trim to essentials with a linked subcommands table, move
  advanced flags to reference
- Environment setup: lead with VS Code + JetBrains, collapse other
  editors, add --dynamic completions for deno task

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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