| name | rhdh-getting-started-navigate |
| metadata | {"author":"rhoai3-coding-demo","version":"1.0.0","platform-family":"rhdh","platform-baseline":"repo","ocp-baseline":"repo","skill-group":"Developer Hub"} |
| description | Use when learning to navigate the Red Hat Developer Hub 1.10 interface, log in, verify identity, discover software components, use Software Templates, browse TechDocs, test APIs, search for resources, use Developer Lightspeed for RHDH, manage extensions, customize interface settings, or star items for quick access. Do NOT use for installing or configuring a RHDH instance (use rhdh-getting-started-setup).
|
RHDH Getting Started — Navigate
Use this skill to ground developer onboarding and navigation guidance in the
official Red Hat Developer Hub 1.10 documentation for the active baseline in
docs/PLATFORM_BASELINE.md.
Source Grounding
Read references/source-capture.md before using product behavior. Official Red
Hat documentation is product authority.
Purpose of RHDH
Red Hat Developer Hub is an internal developer portal (IDP) that centralizes
infrastructure management, software project generation, tools and services, and
technical documentation. It reduces context switching by unifying code
repositories, CI/CD, monitoring, and API documentation in one interface.
Core capabilities:
- Software Catalog — centralized inventory of components, APIs, systems
- Software Templates — self-service project scaffolding
- TechDocs — docs-as-code rendered inside the portal
- Plugins — extend with Jira, Jenkins, ArgoCD, Kubernetes, etc.
- Global Search — unified search across the software ecosystem
Onboarding Workflow
- Log in — authenticate via SSO, Keycloak, GitHub, GitLab, Azure, or guest
(limited, non-production).
- Verify profile — Settings > User Entity; check ownership card.
- Organize workspace — star frequently used components, pin sidebar.
- Explore production resources — browse Docs, APIs, Software Templates.
Interface Navigation
Global Header
- Search — locate components, APIs, docs, and users instantly.
- Create (+) — access Software Templates for self-service scaffolding.
- User profile — manage settings, appearance (Light/Dark/Auto), log out.
- Help (?) — support resources and Quick start panel.
- Starred Items — bookmarked entities.
- Application Launcher — integrated applications and tools.
Left Navigation Sidebar
- Home — personalized dashboard with team updates and recent items.
- Catalog — software components, services, and resources inventory.
- Docs — TechDocs library linked to software entities.
- APIs — centralized API definition browser.
Software Catalog
Filter components by Kind (Component, API, Template, Group), Type (Library,
Website, Service, Tool), Owner, and Lifecycle (production, experimental,
deprecated). Select a component card to view Overview, Docs, Dependencies, and
Relations tabs.
Software Templates
Create new components via Catalog > Self-service or Create (+) in the header.
Templates use YAML definitions with sequential actions (scaffolding, repo
creation, CI/CD setup). Required permissions: scaffolder.template.parameter.read,
scaffolder.template.step.read, scaffolder.task.create.
Import templates via catalog.locations in app-config.yaml:
catalog:
rules:
- allow: [Template]
locations:
- type: url
target: https://<repository_url/template-name>.yaml
TechDocs
Docs-as-code documentation rendered inside the portal. Search, filter by
Owner, Tags, Starred, or Owned. Navigate content using table of contents,
navigation menu, and search bar within documents.
API Browser
Browse APIs via the left sidebar or Catalog > Kind: API. View Definition tab
for rendered Swagger/AsyncAPI/GraphQL. Interactive testing: Try it out > enter
parameters > Run. Supported formats: OpenAPI, AsyncAPI, GraphQL.
Global Search
Unified search indexes the entire software ecosystem. Filter results by Kind,
Type, and Lifecycle. Results categorize matches as Components, APIs, TechDocs,
and Users.
Developer Lightspeed for RHDH
AI assistant for platform questions, log analysis, code generation, and test
plans. Features:
- Thinking cards with reasoning visibility
- MCP tool call transparency
- RAG citations from internal documentation
- Context preservation across model changes
- Notebooks for private knowledge bases (Developer Preview)
Safety guards use Llama Guard by default; configurable via run.yaml.
Extensions Marketplace
Browse extensions via left sidebar > Extensions. Categories: Installed,
Available. End users typically cannot install plugins; contact administrator
to request new integrations.
Interface Customization
Settings > Appearance:
- Theme: Light, Dark, Auto
- Language: preferred interface language
- Pin Sidebar: keep left navigation expanded (enabled by default)
Profile: verify User Entity, view Direct Relations vs Aggregated Relations.
Starred Items
Star components in Catalog > Actions column (star icon). Access starred items
from the Home page (Your Starred Entities card) or Starred Items in the header.
Workflow
- Confirm the active RHDH baseline in
docs/PLATFORM_BASELINE.md.
- Read
references/official-doc-extraction.md for detailed feature coverage.
- Log in and verify your identity and ownership.
- Explore the Software Catalog, APIs, TechDocs, and Templates.
- Customize your workspace (starred items, theme, pinned sidebar).
- Use Developer Lightspeed for AI-assisted help if configured.
Related Skills
- Use
rhdh-getting-started-setup for installing and configuring a RHDH
instance, authentication, and RBAC setup.
References
references/source-capture.mdreferences/official-doc-extraction.md
