---
title: "Contributor Profile Registration Guide"
description: Der Contributor Profile Registration Guide erklärt, wie Partner- und Core-Contributor-Profile im Repository des STACKIT Cloud Framework registriert werden.
scfAsset:
category: "guide"
external: false
tags: ["Contributors", "Onboarding", "Astro"]
maintainers:
- user: "tobias.mueller"
source_url: "https://framework.stackit.cloud/de/advisory/assetcontainer/stackit/howto-contributors/"
source_file: "docs/de/advisory/assetcontainer/stackit/howto-contributors.mdx"
---
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:
```markdown
---
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
---
## 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 ``. Ein Import ist nicht nötig (wird automatisch ergänzt), und das Logo wird automatisch aus dem Ordnernamen des Profils aufgelöst.