- HTTPProxy Fundamentals
- Virtual Hosts
- Inclusion and Delegation
- TLS Termination
- Upstream TLS
- Request Routing
- External Service Routing
- Request Rewriting
- Upstream Health Checks
- Client Authorization
- TLS Delegation
- Rate Limiting
- Access logging
- Annotations Reference
- Cookie Rewriting
- API Reference
- Deployment Options
- Contour Configuration
- Upgrading Contour
- Enabling TLS between Envoy and Contour
- Redeploy Envoy
- AWS with NLB
- External Authorization
- JSON logging
- Migrating to HTTPProxy
- Prometheus Metrics
- PROXY Protocol Support
- Resource Limits
- Envoy Administration Access
- Contour Debug Logging
- Envoy Debug Logging
- Visualize the Contour Graph
- Show Contour xDS Resources
- Profiling Contour
- Contour Operator
- Support Policy
- Compatibility Matrix
- Contour Deprecation Policy
- Release Process
- Frequently Asked Questions
Getting Started with Contributing
Thanks for your interest in contributing to Contour. Community contributions are always needed, welcome, and appreciated. This guide shows how you can contribute to Contour in the following areas:
Please familiarize yourself with the Code of Conduct and project Philosophy before contributing.
Getting Started with Code
Everything is managed on the Project Contour GitHub organization. Create an issue for a new idea or look for issues labeled good first issue to get started.
How we work
See How We Work for an overview:
- Issue management
- Code reviews
- Coding practice
- GitHub labels
Review the Contribution workflow to understand how to work with the code.
Below is a list of workflow areas:
- Building from source
- Contribution workflow
- Contour testing
- Developer Certificate of Origin (DCO) sign off
Getting Started with the Website
Updates, corrections, or improvements are managed through GitHub issues.
When you are ready to take on an issue, see Website Contribution Guidelines to understand how the Contour website contributions are managed. There is information on:
- Site structure
- Link formatting
- Setting up your environment
Getting Started with Documentation
Documentation is critical to the success of any project. Open to all levels, Contour needs help to create and update its documentation. Join an office hours meeting and learn more about the Tech Docs Working Group.
Review the Contour Technical Documentation Contributing Guide for instructions to set up your environment.
Technical documentation will follow the Website Contribution Guidelines.
New documentation suggestions
If you have a document suggestion, create an issue in GitHub. The team will triage and prioritize the issue. Connect on Slack or in a meeting to discuss your issue or request.
Helping with identified document issues
Take a look at the project issues list with the label area/documentation. If you are new to technical writing, add in the good first issue label: area/documentation and good first issue
Reach out on Slack or a Contour meeting for any assistance. Help is always appreciated.
Filing and Working on Issues
Whether code, website, or documentation, Contour uses GitHub to create, track, and manage all issues.
If there is a fix or a suggestion for improvement, create an issue in GitHub.
All issues are reviewed and evaluated by the Contour team.
Meet the Community and the Team
To find out more about contributing to Contour, connect with us at a Contour Community Meeting, on Slack, or through the mailing list. We also have an Office Hours meeting to answer “How do I…” questions.
Contour Community meetings
Discuss issues, features, or suggestions with the Contour team and other community members.
See the Community page for:
- Meeting schedule
- Meeting notes with zoom link
- Meeting recordings
Contour Office Hours meetings
Ask anything during office hours and find out more about Contour.
- “How do I do this in Contour?”
- “Why does Contour do this thing this way?”
- “Where can I find…?”
See the Office Hours page for:
- Meeting schedule
- Meeting link
- Meeting recordings
To get email updates to Contour, join the mailing list. Topics include:
- Release notifications
- Feedback and suggestions
- Meeting notifications
There are many ways to connect with the Contour team:
- Slack: Kubernetes #contour
- Contour YouTube Channel: CNCF Contour
- Twitter: @projectcontour
- GitHub: projectcontour
Want More Contributing Information?
Slack or a meeting is a great way to introduce yourself. Let us know what you are interested in, your background, and what you want to accomplish.
Come out and join a Community meeting or an Office Hours meeting. Ask questions about how to get started or just sit back and get to know the team.