Update remaining enterprise-contract references after quay.io migration

[fullsend-ai-retro]

What happened

PR #242 (#242) updated quay.io image references from enterprise-contract to conforma. However, multiple other references to the old naming remain across the documentation:

1. enterprisecontract.dev URLs (hitchhikers-guide.adoc, 4 occurrences) — links to old domain for CLI docs, policy authoring, policy input, and configuration pages
2. github.com/enterprise-contract (slsa.adoc:156) — GitHub org link that should likely point to github.com/conforma
3. enterprise-contract-service Kubernetes namespace (custom-data.adoc, lines 37, 64, 227) — kubectl commands referencing old namespace
4. verify-enterprise-contract Tekton task name (getting-started.adoc:19, reproducing-a-konflux-conforma-report.adoc:14)
5. pipeline-enterprise-contract quay.io path and GitHub path (getting-started.adoc:18, 22)

The glossary terms (Enterprise Contract, Enterprise Contract Policy) may be intentionally retained since they document the former name.

What could go better

The review process (whether human or automated) could have identified these residual references and flagged them — either as in-scope for the same PR or explicitly documented as known follow-up work. The enterprisecontract.dev URLs are particularly concerning because if the old domain is retired or stops redirecting, documentation links will break.

There is some uncertainty here: some references (like Kubernetes namespace names and Tekton task names) may refer to external resources that genuinely still use the old naming and cannot be updated in documentation alone. The GitHub org URL and enterprisecontract.dev domain references, however, are almost certainly stale.

Confidence: Medium-high that enterprisecontract.dev URLs and github.com/enterprise-contract need updating. Medium confidence that Kubernetes namespace and task name references should be updated (depends on whether the upstream resources were also renamed).

Proposed change

Audit and update remaining enterprise-contract references in the documentation:

1. Replace enterprisecontract.dev URLs in modules/ROOT/pages/hitchhikers-guide.adoc with equivalent conforma.dev URLs (verify the new URLs exist first)
2. Update github.com/enterprise-contract in modules/ROOT/pages/slsa.adoc to github.com/conforma
3. Verify whether enterprise-contract-service Kubernetes namespace has been renamed, and if so, update references in modules/ROOT/pages/custom-data.adoc
4. Verify whether verify-enterprise-contract Tekton task and pipeline-enterprise-contract pipeline have been renamed, and if so, update references in getting-started.adoc and reproducing-a-konflux-conforma-report.adoc
5. Consider adding a redirect or note if some old references must be kept for backward compatibility

Validation criteria

1. Running grep -r 'enterprise.contract' modules/ returns only intentionally retained references (e.g., glossary definitions explaining the former name)
2. All documentation URLs resolve to valid pages (no 404s from retired domains)
3. Code examples in documentation use current namespace/task names that match the deployed infrastructure

---

Generated by retro agent from #242

[fullsend-ai-triage]

🤖 Finished Triage · ✅ Success · Started 12:14 PM UTC · Completed 12:18 PM UTC
Commit: 87c4a29 · View workflow run →

[fullsend-ai-triage]

Triage Summary

Severity: Medium · Category: Documentation

Problem

PR #242 updated quay.io image references but left 13+ other enterprise-contract references across the documentation. Confirmed the following still exist in the codebase:

Category	File(s)	Count	Confidence
enterprisecontract.dev URLs	hitchhikers-guide.adoc	4	High — domain likely stale
github.com/enterprise-contract	slsa.adoc	1	High — org is now conforma
enterprise-contract-service namespace	custom-data.adoc	3	Medium — verify upstream
verify-enterprise-contract task	getting-started.adoc, reproducing-a-konflux-conforma-report.adoc	2	Medium — verify upstream
pipeline-enterprise-contract path	getting-started.adoc	2	Medium — verify upstream

Glossary references in glossary.adoc appear intentionally retained to document the former name.

Recommended Approach

Tier 1 (high confidence): Replace enterprisecontract.dev URLs with conforma.dev equivalents and update the GitHub org link in slsa.adoc. Verify the new URLs resolve before merging.

Tier 2 (verify first): Check whether the Kubernetes namespace, Tekton task name, and pipeline name have been renamed in the upstream infrastructure. Only update documentation if the upstream resources now use conforma naming.

Proposed Validation

# After changes, only intentional glossary references should remain:
grep -rn 'enterprise.contract' modules/ --include='*.adoc'
# Expected: only glossary.adoc entries

# Verify all documentation URLs resolve:
# (check enterprisecontract.dev -> conforma.dev equivalents return HTTP 200)

---

Labels: This is a documentation update issue. Adding 'documentation' label and 'triaged' label per repo conventions. Removing 'ready-for-triage' since triage is complete.

[fullsend-ai-coder]

🤖 Finished Code · ✅ Success · Started 12:19 PM UTC · Completed 12:29 PM UTC
Commit: 87c4a29 · View workflow run →