Files
skillshare/CONTRIBUTING.md
T
Willie ec6d3dbf11 docs: add French, German, Spanish and Brazilian Portuguese READMEs
Readers in these languages had only the English README. The language
bar follows the CONTRIBUTING order by language code, and the release
skill now lists the new files so their Latest callout is updated with
the others.
2026-10-07 15:41:50 +08:00

3.3 KiB

Contributing to skillshare

Thanks for your interest in contributing! This guide helps you get started.

Start with an Issue

The best way to contribute is to open an issue. Issues are where ideas, feature requests, and design discussions happen. This helps us:

  • Align on whether the change fits the project direction
  • Agree on scope and approach before any code is written
  • Avoid investing time in work that may not be merged

Please open an issue before writing code, even if you're confident in the approach. Skipping this step is the most common reason contributions can't be accepted.

Pull Requests

What PRs are good for

PRs work best for small, focused changes:

  • Bug fixes with a clear reproduction
  • Typo and documentation corrections
  • Small improvements (a few files, under ~200 lines of meaningful change)

These can go straight to a PR (still link to an issue if one exists).

Feature Ideas

For new features or large changes:

  1. Open an issue to describe the idea and the problem it solves
  2. Submit a proposal — copy proposals/TEMPLATE.md, fill it in, and open a PR to proposals/

Approved proposals will be added to the roadmap. Implementation is handled by the maintainer to ensure consistency with the project's architecture and codebase conventions.

Note: Due to the nature of this project, most feature PRs won't be merged directly — but every contribution is valuable. Your PR serves as a concrete reference that shapes the final implementation.

PR Checklist

  • Linked to an issue (required for features, recommended for bug fixes)
  • Tests included and passing (make check)
  • No unrelated changes in the diff
  • Commit messages explain "why", not just "what"
  • Scope is focused — one concern per PR

Translated READMEs

The language links at the top of each README are sorted by language code (de, es, fr, ja, ko, pt-BR, zh-CN, zh-TW), with English first as the source. Add a new language at its place in that order, name the file README-<code>.md, and use the language's own name without a region or flag.

Development Setup

All development and testing should be done inside the devcontainer. This ensures a consistent environment (Go toolchain, Node.js, pnpm, and demo content are pre-configured).

Repository-specific task context is indexed in the developer wiki. Agents should load the closest topic with python3 scripts/ai-context.py <topic> before making changes.

git clone https://github.com/runkids/skillshare.git
cd skillshare
make devc            # start devcontainer + enter shell (one step)

Once inside the devcontainer:

make build           # build binary → bin/skillshare
make test            # unit + integration tests
make check           # fmt + lint + test (must pass before PR)
make ui-dev          # Go API server + Vite HMR for Web UI

Other devcontainer commands:

make devc-down       # stop devcontainer
make devc-restart    # restart devcontainer
make devc-reset      # full reset (remove volumes)
make devc-status     # show devcontainer status

Questions?

Not sure where to start? Browse open issues or open a new one to discuss your idea.