# Documentation Contribution Guide

Use this guide when adding or editing roadmap documentation.

## Resource Selection Criteria

Prefer resources that are:

- free or openly accessible
- from official documentation, universities, trusted educators, or mature open
  source projects
- current enough for modern generative AI practice
- clear about prerequisites and learning outcomes
- useful for building a concrete project or skill

Avoid resources that are:

- only promotional
- locked behind unclear paywalls
- duplicated across many sections
- short links when a canonical URL is available
- placeholders or links without context

## Topic Page Template

```markdown
# Topic Name

## Why It Matters

Explain the practical relevance in 2-4 sentences.

## Prerequisites

- prerequisite 1
- prerequisite 2

## Core Concepts

- concept 1
- concept 2
- concept 3

## Best Resources

### Resource Name
URL

Why this is useful.

## Practice Milestones

- small exercise
- project milestone
- portfolio-ready build

## Related Topics

- Related Topic: `../path/topic.md`
```

## Maintenance Checklist

- Verify that links open successfully.
- Replace shortened URLs with canonical URLs where possible.
- Keep resource lists focused instead of exhaustive.
- Add difficulty level when it helps learners choose.
- Link related docs so readers can move through the roadmap naturally.