Register Component into Software Catalog and set up TechDocs publishing

.github/workflows/publish-techdocs.yaml

@@ -0,0 +1,22 @@
+name: Publish TechDocs
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+      - 'mkdocs.yml'
+      - 'catalog-info.yaml'
+      - '.github/workflows/publish-techdocs.yaml'
+concurrency:
+  group: '${{ github.workflow }}-${{ github.ref }}'
+  cancel-in-progress: true
+jobs:
+  publish-docs:
+    uses: grafana/shared-workflows/.github/workflows/publish-techdocs.yaml@main
+    secrets: inherit
+    with:
+      namespace: default
+      kind: component
+      name: alloy-configurator
+      default-working-directory: .

catalog-info.yaml

@@ -0,0 +1,17 @@
+apiVersion: backstage.io/v1alpha1
+kind: Component
+metadata:
+  name: alloy-configurator
+  title: alloy-configurator
+  description: |
+    easy to use web interface for creating and editing alloy configuration files
+  links:
+    - title: Slack Channel
+      url: #growth-and-onboarding-team
+  annotations:
+    backstage.io/techdocs-ref: dir:.
+    github.com/project-slug: grafana/alloy-configurator
+spec:
+  type: service
+  owner: group:default/devex
+  lifecycle: production

mkdocs.yml

@@ -0,0 +1,14 @@
+# To run locally
+# npx @techdocs/cli serve -v -c ./mkdocs.yml
+# 
+site_name: 'alloy-configurator Internal Documentation'
+repo_url: https://github.com/grafana/alloy-configurator
+edit_uri: edit/main/docs
+
+theme:
+  name: material
+  features:
+    - navigation.sections
+
+plugins:
+  - techdocs-core