# Contributing

Thanks for helping keep Awesome Group Generators accurate.

## Ways to contribute

- Report a broken link or stale description.
- Point out a missing feature.
- Dispute a rating with evidence.
- Suggest a new group generator.
- Submit a pull request that updates `data/tools.json` and `data/tools.csv`.

## What makes a good correction

Please include:

1. Tool name and URL.
2. What the current dataset says.
3. What you believe is wrong.
4. Evidence: reproduction steps, screenshots, docs links, or a short recording.
5. Whether the feature works without an account, payment, app install, or special setup.

## Review principles

Ratings are editorial and follow [`METHODOLOGY.md`](./METHODOLOGY.md). A correction request can prove that a factual detail is stale, but it does not automatically determine the final score.

The most important rule: we rate **group generation**, not the parent product. A classroom platform, presentation tool, spreadsheet, AI assistant, or picker gets credit only for features that materially help create groups.

## Data format

The canonical public dataset is [`data/tools.json`](./data/tools.json). The CSV file is a derived spreadsheet-friendly view.

If editing by hand, keep:

- scores on a 0.0–5.0 scale
- feature values as `yes`, `partial`, `no`, or `na`
- pros and cons factual and concise
- pricing notes scoped to the reviewed group-generator workflow

## Conduct

Blunt criticism of tools is allowed; personal attacks are not. Vendor corrections are welcome when evidence is provided, but this is not a paid listing and ratings are not vendor-controlled.