Conclusion and next steps

Congratulations! You’ve completed the Getting started with Red Hat Showroom workshop.

What you’ve learned

Throughout this workshop, you gained hands-on experience with:

  • How Showroom works — AsciiDoc content in Git, rendered by Antora, delivered via GitHub Pages or the Red Hat Demo Platform

  • Creating a Showroom repository from the nookbag template using gh repo create --template

  • Configuring the four key files: site.yml, antora.yml, ui-config.yml, and nav.adoc

  • Generating hands-on lab content using the /showroom:create-lab AI skill

  • Validating content quality with /showroom:verify-content

  • Previewing locally with Podman and publishing to GitHub Pages

  • (If you completed Module 4) Creating presenter-led demo content using /showroom:create-demo and the Know/Show structure

You now have the skills to create professional workshops and demos for any Red Hat product.

Key takeaways

  1. Showroom is AsciiDoc in a Git repo: All content is version-controlled, collaborative, and reviewable — no more fragile PDFs or slide decks

  2. The nookbag template gets you started fast: One gh repo create --template command gives you the correct structure, GitHub Pages workflow, and Antora configuration

  3. AI skills accelerate authoring: /showroom:create-lab and /showroom:create-demo generate production-quality content in minutes, following Red Hat style and accessibility standards automatically

  4. Two content types, one repo: Labs for hands-on learning, demos for presenter-led walkthroughs — both live in the same Showroom repository

  5. Two delivery models, one repo: The same content works on GitHub Pages (for previewing and sharing) and on the Red Hat Demo Platform (for the full split-pane experience with embedded terminals)

From Widget Server to your real product

Everything you built with the fictional Widget Server applies directly to your real product:

  1. Create a new Showroom repo: gh repo create rhpds/<your-product>-showroom --template rhpds/showroom_template_nookbag --public --clone

  2. Clean and configure with Claude Code

  3. Run /showroom:create-lab with your real product documentation as reference material

  4. Optionally add a demo with /showroom:create-demo

  5. Publish and share with the field team

The process is identical. The only difference is the reference materials you feed the skills.

Next steps

Add more modules

Add modules to your workshop by running /showroom:create-lab (or /showroom:create-demo) again and choosing "EXISTING lab." The skill detects the next file number, continues your story arc, and updates the navigation automatically.

When you finish your last module, tell the skill it’s the final one — it generates a conclusion page with consolidated references.

Deploy on the Red Hat Demo Platform

Publishing to GitHub Pages is great for previewing and sharing. For the full Showroom experience with embedded terminals, consoles, and clickable execute blocks, deploy your content on RHDP using AgnosticV catalog items.

See the Showroom quick-start guide for deployment instructions.

Explore advanced AsciiDoc features

  • Mermaid diagrams: Add flowcharts and architecture diagrams directly in AsciiDoc

  • Tabbed content: Show platform-specific instructions (e.g., Podman vs Docker) with the tabs extension

  • Execute blocks: Use [source,role="execute"] to create clickable command blocks that work in RHDP deployments

  • Keyboard macros: Use Ctrl+C for formatted keyboard shortcuts (requires experimental: true in antora.yml)

Use other RHDP skills

The RHDP Skills Marketplace has additional skills for the full content lifecycle:

  • /showroom:verify-content — validate content against Red Hat quality standards

  • /showroom:blog-generate — transform workshops into blog posts

  • /agnosticv:catalog-builder — create AgnosticV catalog items for RHDP deployment

References

Showroom documentation

RHDP Skills Marketplace

AsciiDoc and Antora

Share your feedback

Help us improve this workshop:

  • What did you find most valuable?

  • What could be improved?

  • What topics would you like to see covered in a follow-up workshop?

Reach out on Slack: #forum-demo-developers

Thank you!

Thank you for completing this workshop. You are now equipped to create professional, interactive Showroom workshops and demos for any Red Hat product.