Thanks for your interest in improving awesome-free! This document explains how to contribute.
- Check if it exists - Search
services/to avoid duplicates - Create YAML entry - Use
.yaml(not.yml) following the schema - File naming -
services/[category]/[provider-service].yaml(lowercase) - Use the template - Copy from an existing entry in same category
- Cite sources - Link to official docs or < 6-month-old sources
- Test validation - Run
python tools/validate.pyto check schema - Open a PR - Include which fields you verified (not just copy-paste)
- Verify the change - Check official docs; don't rely on rumors
- Update relevant fields - Only change what actually changed
- Update last_verified - Set to today's date
- Add metadata note - Explain what changed
- Test validation - Run
python tools/validate.py - Open a PR - Cite the source of the change
- Broken link - Open an issue with link and when you discovered it
- Service removed free tier - Mark in YAML and add to
archive/discontinued.yaml - Wrong information - Open an issue with correct info + source
Be respectful. We value accuracy over speed. We prioritize users over companies.