Skip to content

feat: Enable policy docs link in Tekton tasks#3196

Draft
dheerajodha wants to merge 2 commits intoconforma:mainfrom
dheerajodha:add-policy-docs-link-to-task
Draft

feat: Enable policy docs link in Tekton tasks#3196
dheerajodha wants to merge 2 commits intoconforma:mainfrom
dheerajodha:add-policy-docs-link-to-task

Conversation

@dheerajodha
Copy link
Contributor

Depends on #3173

Add --show-policy-docs-link=true to all Tekton validation tasks for prod envs.

Changes:

  • verify-enterprise-contract
  • verify-conforma-konflux-ta
  • verify-conforma-konflux-vsa-ta"

dheerajodha and others added 2 commits March 25, 2026 18:27
Give users control over policy documentation links in validation reports.
Defaults to false to keep demo output clean—production CI can opt in with
--show-policy-docs-link=true when they want the help link.

Why default to false? Your colleague nailed it: "for demos it's better if
the default is false, otherwise every example needs to include the flag."
Nobody wants documentation URLs cluttering their quick validation examples.

Implementation:
- Added persistent flag on parent validate command (all subcommands inherit)
- Flag controls display of https://conforma.dev/docs/policy/ link
- Link only appears when violations/warnings exist
- Updated tests to properly initialize flags
- Updated snapshots for new default behavior

Usage:
  # Default - clean output for demos
  ec validate image --image <img> --policy <policy>

  # Opt-in for production/CI
  ec validate image --image <img> --policy <policy> --show-policy-docs-link=true

resolves: EC-1603

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Add --show-policy-docs-link=true to all Tekton validation tasks since
they run in production/CI environments where users benefit from having
the documentation link when violations occur.

Changes:
- verify-enterprise-contract: Added flag to validate image command
- verify-conforma-konflux-ta: Added flag to validate image command
- verify-conforma-konflux-vsa-ta: Added flag to both validate vsa and validate image commands

This ensures CI/production users see the policy documentation link
while demos remain clean (flag defaults to false).

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@coderabbitai
Copy link

coderabbitai bot commented Mar 25, 2026

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 52f479b3-6a10-4cf1-82e9-aad3cb91f396

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant