Diese Seite erklärt, wie eine Profilseite im STACKIT Cloud Framework registriert wird. Dein Profil ist die Seite, auf die jedes Asset zurückverweist, das du beisteuerst. Es zeigt Lesern, wer hinter der Arbeit steht, und sammelt alles, was du beiträgst, an einem Ort.
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 ihr Logo auf jeder Karte, sobald Framework Core die Markenfreigabe hinterlegt hat. Um diesen Fall geht es auf dieser Seite.
- Eine Person trägt im eigenen Namen bei. Dann wird der geteilte Eintrag
open-contributorsgenutzt, statt eine Organisation zu erfinden. Sonst ändert sich nichts: Assets und Trails liegen wie überall unterassetcontainer/open-contributors/, und es gilt dieselbe Review. Weil der Eintrag geteilt ist, trägt er kein Firmenzeichen, und die Zuschreibung an die Person übernimmt dermaintainers-Block auf der jeweiligen Seite. Trage dich dort mituser: dein.benutzernameein.
Ein späterer Wechsel ist nur ein Umzug der Dateien: Sobald die Organisation registriert ist, wandern die Seiten in deren Container.
Profil- und Logo-Pfade
Abschnitt betitelt „Profil- und Logo-Pfade“Der Dateiname deines Profils ist dein Contributor-Slug. Assets, Trails und Logos finden dein Profil über diesen Slug. Deine Assets liegen unter assetcontainer/[partner-slug]/. Das Logo wird im Profilordner mit demselben Namen gefunden.
- Profil-Speicherort: Lege das Contributor-Profil als MDX-Datei unter dem exakten Pfad
docs/contributors/[partner-slug].mdxan. - Asset-Verzeichnis: Speichere alle profilspezifischen Medien im passenden Unterordner
docs/contributors/[partner-slug]/. - Dark-Mode-Logo: Stelle ein quadratisches Bild im Seitenverhältnis 1:1 mit dem exakten Namen
logo.pngoderlogo.svgim partnerspezifischen Unterverzeichnis bereit. Diese Datei erscheint im dunklen Theme. - Light-Mode-Logo: Lege
light-logo.pngoderlight-logo.svgin denselben Ordner, mit denselben Formatregeln. Passt dein Logo auf beide Hintergründe, lege dieselbe Grafik unter beiden Namen ab. - Wenn eine Datei fehlt: Jedes Theme braucht seine eigene Datei. Das Theme ohne Datei zeigt einen neutralen Platzhalter mit deinen Initialen, nie das Logo einer anderen Firma. Reichst du die fehlende Variante nach, ersetzt sie den Platzhalter beim nächsten Build.
Schreibregeln für Profile
Abschnitt betitelt „Schreibregeln für Profile“Mit diesen Regeln baut deine Seite fehlerfrei. Suchmaschinen und KI-Assistenten können dann jeden Teil für sich lesen:
- SEO-Empfehlung: Schreibe eine echte, prägnante Zusammenfassung in das Frontmatter-Feld
descriptionund ziele auf 120 bis 160 Zeichen, genug, um zu sagen, was die Seite bietet. Die Karte zeigt alles davon. Dieser Bereich bringt einen Ranking-Bonus und wird nicht erzwungen. Wird er verfehlt, kostet das nur den Bonus. 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, damit jeder Punkt auch allein verständlich ist. - Vermeidung von Kontextsplitting: Nenne immer den Partnernamen oder den konkreten STACKIT-Service statt vager Pronomen, damit jeder Abschnitt auch allein verständlich ist.
Vollständiges Profilbeispiel
Abschnitt betitelt „Vollständiges Profilbeispiel“Dieses vollständige Beispiel besteht jede Prüfung. Die Seite beginnt mit der Komponente <ScfContributorHeader />, die Markenzeichen und Badge für dich darstellt:
---title: "Mockup Company Inc."description: "Official partner profile of Mockup Company Inc., specialized in sovereign cloud consulting, STACKIT infrastructure and 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.Personen nennt die Seite über maintainers an den Assets und über ihre eigene Erklärung, nicht im Profil der Organisation.
Um ein neues Contributor-Profil vollständig zu registrieren, folge diesen Schritten.
-
Profildatei erstellen: Lege die MDX-Datei unter
docs/contributors/[partner-slug].mdxmit einem konformen Frontmatter-Block an. -
Brand-Assets hinzufügen: Lege
logo.svgund jedelight-logo.svg-Variante im passenden Partner-Unterverzeichnis ab. -
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.