Contributor Profile Registration Guide

Der Contributor Profile Registration Guide erklärt, wie eine Profilseite im STACKIT Cloud Framework registriert wird. Jedes Contributor-Profil steuert das dynamische Rendering im interaktiven Contributor-Explorer und stellt eine explizite Verbindung zwischen technischen Asset-Containern und der beitragenden Organisation her.

Eine eigene Seite braucht aber nicht jede Person. Es gibt zwei Wege, und welcher der richtige ist, hängt daran, ob eine Firma hinter der Arbeit steht:

• Eine Organisation trägt bei. Sie wird hier registriert und bekommt eine eigene Seite, ein Portfolio über alle ihre Assets und Trails und, sobald Framework Core die Markenfreigabe hinterlegt hat, ihr Logo auf jeder Karte. Um diesen Fall geht es in diesem Guide.
• Eine Person trägt im eigenen Namen bei. Dann wird der geteilte Eintrag open-contributors genutzt, statt eine Organisation zu erfinden. Sonst ändert sich nichts: Assets und Trails liegen wie überall unter assetcontainer/open-contributors/, und es gilt dieselbe Review. Weil der Eintrag geteilt ist, trägt er kein Firmenzeichen, und die Zuschreibung an die Person übernimmt der maintainers-Block auf der jeweiligen Seite — dort mit user: dein.benutzername eintragen.

Ein späterer Wechsel ist nur ein Umzug der Dateien: Sobald die Organisation registriert ist, wandern die Seiten in deren Container.

Verzeichnisstruktur und Asset-Ablage

Der Contributor Profile Registration Guide erfordert die strikte Einhaltung der Repository-Konventionen des STACKIT Cloud Framework, damit responsive Layouts auf mobilen Bildschirmen erhalten bleiben.

• Profil-Speicherort: Lege das Contributor-Profil als MDX-Datei unter dem exakten Pfad apps/docs/src/content/docs/contributors/[partner-slug].mdx an.
• Asset-Verzeichnis: Speichere alle profilspezifischen Medien im passenden Unterordner apps/docs/src/content/docs/contributors/[partner-slug]/.
• Standard-Logo: Stelle ein quadratisches Bild im Seitenverhältnis 1:1 mit dem exakten Namen logo.png oder logo.svg im partnerspezifischen Unterverzeichnis bereit.
• Light-Mode-Logo: Liefere ein alternatives light-logo.png- oder light-logo.svg-Asset, wenn das Standard-Logo auf hellen Hintergründen zu wenig Kontrast hat.

Authoring- und RAG-Optimierungsregeln

Der Contributor Profile Registration Guide setzt diese Content-Design-Regeln durch, um eine fehlerfreie Kompilierung und hohe semantische Sichtbarkeit für automatisierte Enterprise-RAG-Indexer zu garantieren:

• SEO-Empfehlung: Schreibe eine echte, prägnante Zusammenfassung in das Frontmatter-Feld description und ziele auf 120 bis 160 Zeichen: genug, um zu sagen, was die Seite bietet, und die Karte zeigt alles davon. Das Fenster wird mit einem Ranking-Bonus belohnt statt erzwungen: wird es verfehlt, kostet das nur den Bonus, und die Pipeline warnt erst unter 120 oder über 180 Zeichen. Eine fehlende Description, ein Stummel oder ein Platzhalter lässt sie dagegen scheitern.
• Lead-Term-Muster: Jede Auflistung von Kompetenzen oder Core-Tech-Stacks muss das Muster - **Lead-Begriff**: Erläuterungssatz. verwenden, um das Rendering als Definitionsliste zu erzwingen.
• Vermeidung von Kontextsplitting: Nenne immer den Partnernamen oder den konkreten STACKIT-Service statt vager Pronomen, damit Vektordatenbank-Chunks self-contained bleiben.

Produktives Blueprint-Beispiel

Der folgende Block ist eine vollständig konforme Referenzimplementierung für ein Contributor-Profil. Das Layout nutzt die zentrale Contributor-Header-Komponente, um Markenzeichen und Badges automatisch zu rendern und manuelles Inline-Styling zu ersetzen:

---
title: "Mockup Company Inc."
description: "Official partner profile of Mockup Company Inc. – Specializing in sovereign cloud consulting, STACKIT infrastructure, and fully automated DevOps pipelines."
sidebar:
  hidden: true
---

<ScfContributorHeader title="Mockup Company Inc." badge="Consulting Partner" />

## Company profile

Mockup Company Inc. guides organizations through the migration, modernization, and operation of workloads in sovereign cloud environments. As a core contributor to the STACKIT Cloud Framework, Mockup Company Inc. focuses on production-ready enterprise architectures, cloud automation, and compliance-driven cloud-native solutions.

## Technical core competencies

- **STACKIT SKE**: Design, provisioning, and orchestration of production-ready managed Kubernetes clusters.
- **STACKIT Cloud Foundry**: Deployment, scaling, and lifecycle management of cloud-native applications.
- **Terraform automation**: Declarative provisioning and versioning of STACKIT projects, networks, compute, and SKE.
- **CI/CD pipelining**: Design and implementation of robust delivery tracks for automated quality assurance and continuous deployment.

Um ein neues Contributor-Profil vollständig zu registrieren, folge dem Workflow des Contributor Profile Registration Guide.

1. Profildatei erstellen: Lege die MDX-Datei unter apps/docs/src/content/docs/contributors/[partner-slug].mdx mit einem konformen Frontmatter-Block an.

2. Brand-Assets hinzufügen: Lege logo.svg und jede light-logo.svg-Variante im passenden Partner-Unterverzeichnis ab.

3. Contributor-Header einbinden: Rendere <ScfContributorHeader title="…" badge="…" />. Ein Import ist nicht nötig (wird automatisch ergänzt), und das Logo wird automatisch aus dem Ordnernamen des Profils aufgelöst.