Skip to main content

​
Contributing to TracingInsights

We welcome contributions from the F1 data community! Whether you’ve found a data error, have a feature suggestion, or want to help improve the platform, your input is valuable.

​
Ways to Contribute

Report Data Errors

Found an inconsistency or error in the data? Let us know so we can fix it.

Suggest Features

Have an idea for new data types or improvements? We’d love to hear it.

Improve Documentation

Help make our documentation clearer and more comprehensive.

Sponsor the Project

Support the ongoing development and hosting costs.

​
Reporting Data Errors or Issues

If you discover errors or inconsistencies in the data, please help us improve accuracy by reporting them.

​
How to Report

  1. Check existing issues: Visit the GitHub Issues page to see if the issue has already been reported.
  2. Create a new issue: If your issue is new, click “New Issue” and provide:
    • Session details: Race, session type (FP1, Qualifying, Race, etc.)
    • Specific error: What data is incorrect or missing
    • Expected behavior: What the data should show
    • Evidence: Screenshots, official timing data, or other sources
  3. Alternative contact: If GitHub isn’t convenient, contact us directly
Please be as specific as possible when reporting errors. Include lap numbers, driver names, timestamps, and any other relevant details.

​
Example Issue Report

**Issue**: Incorrect lap time for Verstappen in Bahrain Qualifying

**Session**: 2026 Bahrain Grand Prix - Qualifying Q3
**Driver**: Max Verstappen (VER)
**Lap**: Lap 2
**Current Data**: 1:29.123
**Expected Data**: 1:28.987
**Source**: Official F1 timing screen (screenshot attached)

**Additional Context**: 
The lap time appears to be from Q2, not Q3.

​
Contributing Code or Data Improvements

While the primary data processing is automated, we welcome contributions that:
  • Improve data validation and error checking
  • Enhance documentation and examples
  • Create tools or scripts for data analysis
  • Develop visualization templates

​
Getting Started

  1. Fork the repository: Create your own fork of TracingInsights/2026
  2. Clone locally: git clone https://github.com/YOUR_USERNAME/2026.git
  3. Create a branch: git checkout -b feature/your-improvement
  4. Make changes: Implement your improvements
  5. Test thoroughly: Ensure your changes work as expected
  6. Submit a pull request: Describe your changes and their benefits
For significant changes, please open an issue first to discuss your proposed approach.

​
Data Accuracy Improvements

Helping us maintain high data quality is one of the most valuable contributions.

​
What to look for:

  • Missing data: Sessions or laps with incomplete information
  • Incorrect lap times: Times that don’t match official sources
  • Telemetry anomalies: Unrealistic speed, RPM, or other telemetry values
  • Wrong driver assignments: Data attributed to the wrong driver
  • Session classification errors: Laps marked as wrong session type

​
Verification sources:

  • Official F1 timing app
  • FIA official documents
  • Team radio and onboard footage
  • Reliable F1 statistics websites

​
Community Guidelines

To maintain a positive and productive community:
  • Be respectful: Treat all contributors with courtesy and professionalism
  • Be constructive: When reporting issues, focus on solutions
  • Be patient: Understand that this is a community-driven project
  • Be accurate: Verify information before reporting errors
  • Be collaborative: Work together to improve the platform
This project is maintained by volunteers. Response times may vary, especially during busy race weekends.

​
Recognition

We value all contributions and will:
  • Credit significant contributors in release notes
  • Acknowledge data error reports in issue comments
  • Feature outstanding community projects on our website

​
Other Ways to Help

Even if you’re not reporting issues or contributing code:
  • Star the repository: Show support on GitHub
  • Share your projects: Show us what you’ve built with the data
  • Spread the word: Tell other F1 enthusiasts about the platform
  • Provide feedback: Let us know how we can improve

​
Contact

For questions about contributing or general inquiries:
Thank you for contributing to TracingInsights! Your efforts help make F1 data more accessible and accurate for everyone in the community.
Disclaimer: TracingInsights is not affiliated with Formula 1, FIA, or any F1 team. All trademarks belong to their respective owners.

Build docs developers (and LLMs) love

Get started for freeTalk to us