# Contributing Guide

Thanks for improving this repository. Keep contributions clear, factual, and easy to review.

## What We Accept

- Open-source or freely accessible tools, models, datasets, papers, and docs.
- Official links first (GitHub repo, paper, project page, docs).
- One-line descriptions focused on what the resource does.

## Where to Add

- Speech: `docs/stt-models.md`, `docs/stt-datasets.md`, `docs/tts.md`, `docs/voice-cloning.md`, `docs/emotion-recognition.md`
- Vision and media: `docs/text-to-image.md`, `docs/talking-head.md`
- Agents and workflows: `docs/ai-agents.md`
- Foundation models and APIs: `docs/transformers.md`, `docs/genai-apis.md`
- Tool integration: `docs/mcp.md`
- Broad references: `docs/more_detailed.md`

## Entry Quality Rules

- Use concise descriptions (about 8-15 words).
- Avoid promotional wording and subjective claims.
- Keep table format consistent with surrounding section.
- Do not duplicate an existing entry.
- Prefer ASCII text when possible.

## Recommended Entry Formats

Table row:

`| **Project** | - | Short factual description | [Repo](https://github.com/org/repo) |`

Bullet entry:

`- [Project](https://github.com/org/repo) - Short factual description`

## Pull Request Checklist

1. Added entry to the correct file and section.
2. Verified link is valid and points to the official source.
3. Kept wording concise and consistent with file style.
4. Confirmed no duplicate project already exists.
5. Included a short PR summary of what changed.

## Submitting Changes

1. Fork the repository.
2. Create a branch.
3. Make edits in the correct file(s).
4. Open a PR with a short, clear summary.