Skip to content

docs: fix issues from workshop tester feedback#177

Merged
Roming22 merged 3 commits into
redhat-appstudio:mainfrom
gtrivedi88:fix/workshop-feedback
Apr 28, 2026
Merged

docs: fix issues from workshop tester feedback#177
Roming22 merged 3 commits into
redhat-appstudio:mainfrom
gtrivedi88:fix/workshop-feedback

Conversation

@gtrivedi88

Copy link
Copy Markdown
Contributor

Summary

  • Route commands: Use items[0] selector instead of hardcoded route names (names are auto-generated and vary per deployment)
  • Pre-provisioned environments: Add --force note for tsf config --create and skip note for Quay integration when secrets already exist
  • cosign: Note that it must be installed on the local machine, not available in the installer container
  • Konflux UI flow: Update to current UI — View my namespaces → select tenant → Create Application; Add component moved under Actions dropdown
  • GitLab support: Add GitLab example URL for component creation
  • Namespace updates: Rename tssc-keycloaktsf-keycloak; add missing namespaces (cert-manager, konflux-cli, konflux-info, tsf) to deployed components list
  • Troubleshooting: Reference manageSubscription: auto alongside false

Items for SME verification

These changes match what the workshop tester observed. Please confirm:

  1. UI flow: Is the current flow View my namespaces → select tenant → Create Application? (workshop tester confirmed this is what they saw)
  2. Actions dropdown: Is Add component now under the Actions dropdown on the application page?

Test plan

  • Verify Antora build passes
  • SME confirms UI flow matches current Konflux UI
  • SME confirms namespace names are current

🤖 Generated with Claude Code

Address documentation issues reported during TSF workshop testing:
- Use items[0] selector for route commands (names are auto-generated)
- Add --force note for tsf config --create in pre-provisioned envs
- Add note to skip Quay integration if secret pre-exists
- Note that cosign must be installed locally, not in installer container
- Update UI flow: View my namespaces → select tenant → Create Application
- Move Add component under Actions dropdown
- Add GitLab example URL for component creation
- Rename tssc-keycloak namespace to tsf-keycloak
- Add missing namespaces (cert-manager, konflux-cli, konflux-info, tsf)
- Update troubleshooting to reference manageSubscription auto value

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Comment thread docs/modules/ROOT/pages/getting-started.adoc Outdated
Comment thread docs/modules/ROOT/pages/troubleshooting.adoc Outdated
Comment thread docs/modules/ROOT/pages/verifying-and-accessing.adoc Outdated
gtrivedi88 and others added 2 commits April 28, 2026 20:57
- Link to RHTAS docs for downloading cosign from the cluster
- Remove Cert-Manager steps from installing (auto is now default)
- Remove Cert-Manager troubleshooting section (no longer applicable)
- Use label selector for Konflux UI route instead of items[0]

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add {RHTASVersion} attribute (1.4) to antora.yml so the RHTAS docs
version can be updated in one place. Link cosign verification step
to RHTAS "Signing and verifying containers" section for download
and setup instructions.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@gtrivedi88 gtrivedi88 requested a review from Roming22 April 28, 2026 15:38
@Roming22 Roming22 merged commit a8aaf23 into redhat-appstudio:main Apr 28, 2026
1 check passed
Roming22 pushed a commit to Roming22/tsf-cli that referenced this pull request Apr 30, 2026
- Link to RHTAS docs for downloading cosign from the cluster
- Remove Cert-Manager steps from installing (auto is now default)
- Remove Cert-Manager troubleshooting section (no longer applicable)
- Use label selector for Konflux UI route instead of items[0]

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Roming22 pushed a commit to Roming22/tsf-cli that referenced this pull request Apr 30, 2026
- Link to RHTAS docs for downloading cosign from the cluster
- Remove Cert-Manager steps from installing (auto is now default)
- Remove Cert-Manager troubleshooting section (no longer applicable)
- Use label selector for Konflux UI route instead of items[0]

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants