How to Contribute
Submit telemetry updates, evidence, and docs that keep the comparison accurate. Follow the paths below, then open a GitHub PR.
Contribution Paths
Choose a path: telemetry data, validated evidence, or community issues
Telemetry updates
We welcome all kinds of contributions to the EDR_telem.json file. Use our tools to make contributing easier.
- Convert between JSON and CSV formats
- Edit in your preferred format
- Automatic validation checks
Evidence Requirements
Status changes need recheckable evidence. Screenshots help. Disputed direct-test conclusions need the full evidence package.
Accepted evidence
Direct-test checklist
For No or absence findings
Document the search window, sources searched, queries or search terms, covered time range, endpoint identifiers examined, and any relevant vendor table or index guidance. Vague claims are not enough to upgrade or downgrade a status.
Contribution Steps
Fork, branch, update statuses with evidence, then open a pull request
Fork Repository
Create your own copy of the project.
- Visit the main repository
- Click the "Fork" button
- Select your account
Create Branch
Make a new branch for your changes.
git checkout -b feature-branch-nameMake Changes
Update telemetry values using the project status vocabulary.
Submit PR
Open a pull request with documentation and evidence.
- Push your changes
- Open pull request
- Add documentation
- Wait for review
Additional Guidelines
Keep issues and feature requests clear, current, and easy to act on
Reporting Issues
- Check existing issues
- Use latest version
- Clear descriptions
- Reproduction steps
Feature Requests
- Check existing proposals
- Clear title
- Detailed description
- Use case examples
Contribution FAQ
Quick answers drawn from the contribution and evidence guidance above
Contribute on GitHub
Small, well-evidenced PRs still matter. Open an issue first if the change needs discussion.