Skip to content

docs: add TechDocs scaffold for Backstage#9

Merged
Yomanz merged 2 commits into
masterfrom
docs/techdocs-scaffold
May 18, 2026
Merged

docs: add TechDocs scaffold for Backstage#9
Yomanz merged 2 commits into
masterfrom
docs/techdocs-scaffold

Conversation

@Yomanz

@Yomanz Yomanz commented May 18, 2026

Copy link
Copy Markdown
Member

Summary

Adds a Backstage TechDocs scaffold so hookla renders documentation in the WidgetBot developer portal and appears in the service catalog.

  • docs/index.md — overview of hookla: what it does, architecture (Scala/Finch/Quill/Flyway), key directories, configuration, local run, and deployment.
  • mkdocs.ymlsite_name, nav, and techdocs-core plugin.
  • catalog-info.yaml — new Backstage Component (kind: Component, owner group:widgetbot, system widgetbot) with the backstage.io/techdocs-ref: dir:. annotation.

Test plan

  • Backstage picks up catalog-info.yaml and shows hookla in the catalog
  • TechDocs renders the docs/ tab from mkdocs.yml

@Yomanz Yomanz merged commit 60a7567 into master May 18, 2026
1 check passed
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.

1 participant