Skip to content

[Tier 2] Curate 5-10 good first issue items for newcomers #11

Description

@justsml

Problem

There are no curated good first issue items in the issue tracker. New contributors land in the repo, see deep technical work, and leave because they can't find an entry point.

Goal

Create 5–10 small, well-scoped issues labeled good first issue that newcomers can pick up and complete in a single evening.

Acceptance Criteria

  • Review TODO.md and identify small, isolated tasks
  • Create issues for each of the following (or similar):
    1. Fix a typo or outdated link in README/AGENTS.md
    2. Add JSDoc comments to 3 public functions in src/server/db/
    3. Improve error message clarity in src/server/approvals/
    4. Add a missing test case to tests/security-chat/ui-blocks.test.ts
    5. Update docs/tools/ with a tool you know well
    6. Add a loading state to a React component
    7. Improve the pnpm setup error messages
    8. Add a11y labels to form inputs in src/components/
  • Label each with good first issue
  • Include clear acceptance criteria and context in each issue
  • Pin a meta-issue or add a section to CONTRIBUTING.md listing them

Context

  • TODO.md has many gaps that can be decomposed into small tasks
  • Tests in tests/security-chat/ are a good place for newcomers to learn the codebase
  • docs/tools/ has 138 files but many could use updates

Labels

dx, tier-2-growth-accelerator, good first issue

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions