Skip to content

docs: Document HTTPProxy status conditions - #7631

Open
AkashKumar7902 wants to merge 2 commits into
projectcontour:mainfrom
AkashKumar7902:agent/docs-3144-httpproxy-status
Open

docs: Document HTTPProxy status conditions#7631
AkashKumar7902 wants to merge 2 commits into
projectcontour:mainfrom
AkashKumar7902:agent/docs-3144-httpproxy-status

Conversation

@AkashKumar7902

@AkashKumar7902 AkashKumar7902 commented Jul 18, 2026

Copy link
Copy Markdown
Contributor

Fixes #3144

What this PR does

  • documents the Contour-managed Valid condition as the detailed HTTPProxy processing result
  • explains observedGeneration, errors, warnings, and the derived currentStatus and description fields
  • replaces obsolete status examples with current valid and unresolved-Service condition output

Why

The fundamentals page only showed the summary status fields and had not been updated for condition-based status reporting. This left users without documentation for the structured diagnostics Contour currently writes.

User impact

Users can identify the HTTPProxy generation that Contour evaluated and find fatal errors or non-fatal warnings in the correct condition fields.

Release note

Requested label: release-note/docs. The corresponding docs changelog is included.

Testing

  • git diff --check
  • make lint-codespell
  • go test ./apis/projectcontour/v1 ./internal/status ./internal/dag
  • hugo --gc --minify with the Netlify-pinned Hugo 0.152.0

Signed-off-by: Akash Kumar <meakash7902@gmail.com>
Signed-off-by: Akash Kumar <meakash7902@gmail.com>
@AkashKumar7902
AkashKumar7902 marked this pull request as ready for review July 18, 2026 21:13
@AkashKumar7902
AkashKumar7902 requested a review from a team as a code owner July 18, 2026 21:13
@AkashKumar7902
AkashKumar7902 requested review from sunjayBhatia and tsaarni and removed request for a team July 18, 2026 21:13
@github-actions

Copy link
Copy Markdown

The Contour project currently lacks enough contributors to adequately respond to all PRs.

This bot triages PRs according to the following rules:

  • After 30d of inactivity, lifecycle/stale is applied
  • After 60d of inactivity since lifecycle/stale was applied, the PR is closed

You can:

  • Ensure your PR is passing all CI checks. PRs that are fully green are more likely to be reviewed. If you are having trouble with CI checks, reach out to the #contour channel in the Kubernetes Slack workspace.
  • Mark this PR as fresh by commenting or pushing a commit
  • Close this PR
  • Offer to help out with triage

Please send feedback to the #contour channel in the Kubernetes Slack

@github-actions github-actions Bot added the lifecycle/stale Denotes an issue or PR has remained open with no activity and has become stale. label Aug 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

lifecycle/stale Denotes an issue or PR has remained open with no activity and has become stale.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

update HTTPProxy status reporting documentation

1 participant