[PR #5922] docs: add guides so users can get started faster #11648

Closed
opened 2026-02-16 18:16:32 -05:00 by yindo · 0 comments
Owner

Original Pull Request: https://github.com/anomalyco/opencode/pull/5922

State: closed
Merged: No


Summary

  • Adds a new Guides section to the documentation navigation
  • Creates a comprehensive "First Hour" guide to help new users get productive quickly

What's in the guide

The guide follows a progressive disclosure pattern - essentials up front, details as you read further:

  1. Quick start essentials - bullet list of the 5 things you need to know
  2. Installation - links to install options
  3. Provider setup - promotes OpenCode Zen, includes opencode auth login option
  4. Project initialization - /init command
  5. File references - using @ to reference files
  6. Plan-Build workflow - core workflow explanation with table
  7. Undo/redo - safety net for mistakes
  8. Shell commands - ! prefix
  9. Sharing - /share command
  10. Quick tips - context, mentoring tone, image paste (Ctrl+V)
  11. MCP servers - Context7 and Exa setup with:
    • Config location explanation (global vs project)
    • Global config example for Context7/Exa
    • Project config example for Neon Postgres
  12. Cheat sheet - quick reference table

Changes

  • packages/web/astro.config.mjs - Added Guides section to sidebar
  • packages/web/src/content/docs/guides/first-hour.mdx - New guide (356 lines)
**Original Pull Request:** https://github.com/anomalyco/opencode/pull/5922 **State:** closed **Merged:** No --- ## Summary - Adds a new **Guides** section to the documentation navigation - Creates a comprehensive "First Hour" guide to help new users get productive quickly ## What's in the guide The guide follows a progressive disclosure pattern - essentials up front, details as you read further: 1. **Quick start essentials** - bullet list of the 5 things you need to know 2. **Installation** - links to install options 3. **Provider setup** - promotes OpenCode Zen, includes `opencode auth login` option 4. **Project initialization** - `/init` command 5. **File references** - using `@` to reference files 6. **Plan-Build workflow** - core workflow explanation with table 7. **Undo/redo** - safety net for mistakes 8. **Shell commands** - `!` prefix 9. **Sharing** - `/share` command 10. **Quick tips** - context, mentoring tone, image paste (Ctrl+V) 11. **MCP servers** - Context7 and Exa setup with: - Config location explanation (global vs project) - Global config example for Context7/Exa - Project config example for Neon Postgres 12. **Cheat sheet** - quick reference table ## Changes - `packages/web/astro.config.mjs` - Added Guides section to sidebar - `packages/web/src/content/docs/guides/first-hour.mdx` - New guide (356 lines)
yindo added the pull-request label 2026-02-16 18:16:32 -05:00
yindo closed this issue 2026-02-16 18:16:32 -05:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#11648