Contributing to RaceData
Thank you for your interest in contributing to the RaceData Formula 1 dataset! This guide explains how you can help improve the dataset.Ways to Contribute
There are several ways you can contribute to this project:Report Data Errors
If you find errors or inconsistencies in the data:- Check if it’s already reported - Search existing issues to avoid duplicates
- Create a detailed issue - Include:
- Which table/file contains the error
- What the current (incorrect) data shows
- What the correct data should be
- Your source/reference for the correction
- Submit the issue on GitHub
Please provide specific references (race name, driver name, date, etc.) to help us quickly locate and fix errors.
Suggest Improvements
Have ideas for improving the dataset or documentation?- Open a feature request issue
- Join the discussions
- Share your use cases to help us understand user needs
Submit Pull Requests
Note: This repository is primarily auto-updated from upstream Kaggle datasets. Manual data changes may be overwritten during the next automated update.
- Fork the repository
- Create a feature branch (
git checkout -b feature/your-feature-name) - Make your changes
- Test your changes thoroughly
- Commit with clear messages describing what and why
- Submit a pull request with a description of your changes
Improve Documentation
Documentation improvements are always welcome:- Fix typos or unclear explanations
- Add examples or use cases
- Improve table descriptions
- Create tutorials or guides
Reporting Issues
Bug Reports
When reporting bugs or data errors, include:- Clear title - Summarize the issue
- Description - Detailed explanation of the problem
- Steps to reproduce - How to verify the issue
- Expected behavior - What should happen
- Actual behavior - What actually happens
- Evidence - Screenshots, data samples, or references
Feature Requests
When suggesting new features:- Describe the use case - Why is this feature needed?
- Proposed solution - How do you envision it working?
- Alternatives considered - Any other approaches you’ve thought about?
- Additional context - Any other relevant information
Code of Conduct
When contributing, please:- Be respectful and constructive in discussions
- Focus on the issue, not the person
- Accept feedback gracefully
- Help create a welcoming environment for all contributors
Contact the Team
Have questions about contributing?- GitHub Issues - TracingInsights/RaceData/issues
- Contact Form - tracinginsights.com/contact
- GitHub Discussions - TracingInsights/RaceData/discussions
Upstream Data Sources
Since this repository automatically syncs from Kaggle datasets, upstream data corrections should be reported to:- jtrotman/formula-1-race-data - Kaggle discussions
- jtrotman/formula-1-race-events - Kaggle discussions
- Ergast/Jolpica - GitHub issues
Support the Project
If you find this dataset valuable:- Star the repository on GitHub
- Sponsor TracingInsights via GitHub Sponsors
- Share the project with others who might benefit
- Follow TracingInsights on social media
License
By contributing to this project, you agree that your contributions will be licensed under the same CC0 1.0 Universal license as the rest of the project.This means your contributions will be dedicated to the public domain and can be used by anyone for any purpose.
Thank you for helping make RaceData better for the entire Formula 1 data community!