---
title: "Dein erster Beitrag: Profil, Asset, Trail"
description: "Drei Stationen zu deinem ersten Beitrag: ein Profil, das sagt, wer du bist, ein Asset mit deinem Wissen und ein Trail, der deine Assets verbindet."
scfTrail:
  tags: ["getting-started", "contributing", "authoring"]
  maintainers:
    - user: "tobias.mueller"
  steps:
    - style: "compass"
      id: "overview"
      title: "Drei Stationen zu deinem ersten Beitrag"
      trailContext: "Ein Profil sagt, wer du bist. Assets tragen, was du weißt. Ein Trail macht daraus eine Journey. Das Studio hilft bei allen dreien."
      imageSrc: "contributors/stackit/files/advisory/scf-onboarding.svg"
      imageAlt: "Die Route auf den Berg: das Profil am Fuß, dein Asset im Explorer auf halber Höhe, der Trail am Gipfel"

    - style: "hut"
      id: "create-profile"
      title: "Eine Seite stellt dich vor"
      trailContext: "Eine Seite je Organisation oder Person, hinzugefügt über einen Pull Request wie jede andere Seite. Ein Review bringt sie online."
      splitRatio: 45
      left:
        text: "Dein Profil ist eine Seite mit deinem Namen, deinem Logo und einer kurzen Beschreibung. Sie kommt über einen normalen Pull Request hinein. Jedes Asset von dir verweist darauf zurück."
      right:
        imageSrc: "contributors/stackit/core/contributor-organisation.svg"
        imageAlt: "Deine Organisation ins Verzeichnis bringen: Profilseite, Pull Request, ein Review, das Profil ist online"

    - role: sub
      id: "files-location"
      title: "Wo deine Dateien liegen"
      trailContext: "Der Ordneraufbau für dein Profil, deine Assets und deine Logo-Dateien."
      assetId: "advisory/assetcontainer/stackit/howto-contributors#directory-structure--asset-placement"

    - style: "stairs"
      id: "asset-frontmatter"
      title: "Aus deinen Metadaten wird die Karte"
      trailContext: "Leser finden die Karte im Explorer, filtern danach und öffnen das Asset von dort."
      splitRatio: 55
      left:
        text: "Ein Asset ist eine MDX-Seite mit einem kurzen Metadatenblock: ein Titel, eine Beschreibung mit 150 bis 160 Zeichen, eine Kategorie und bis zu 10 Tags. Daraus baut die Seite diese Karte."
      right:
        assetId: "de/migration/assetcontainer/stackit/landing-zone-foundation-opentofu"

    - role: sub
      id: "asset-schema"
      title: "Die Regeln für die Metadaten im Detail"
      trailContext: "Jedes Feld, seine Grenzen und die erlaubten Kategorien."
      assetId: "advisory/assetcontainer/stackit/howto-asset-integration#strict-frontmatter-validation-schema"

    - style: "chairlift"
      id: "studio"
      title: "Das Studio schreibt die Metadaten für dich"
      trailContext: "Das Studio läuft in deinem Dev-Container und auf der Dev-Seite. Es schreibt Profile, Assets, Trails und Framework-Seiten."
      splitRatio: 52
      left:
        text: "Du füllst ein Formular aus. Das SCF Studio prüft jedes Feld schon beim Tippen und öffnet den Pull Request für dich. Es lädt auch eine bestehende Seite und ändert nur, was du bearbeitest."
      right:
        imageSrc: "contributors/stackit/core/getting_started/studio.png"
        imageAlt: "Das SCF Studio: rechts ein Formular, links der Aufstieg von Seite zu Seite"

    - style: "gondola"
      id: "configure-trail"
      title: "Ein Trail macht aus Assets eine Journey"
      trailContext: "Die Karte rechts ist die Tour durch die Seite, ein Trail, der genau so gebaut ist."
      splitRatio: 42
      left:
        text: "Ein Trail ist eine Liste von Schritten. Jeder Schritt zeigt auf ein Asset, eine Seite oder einen Abschnitt daraus. Mit einem Bild oder einer zweiten Spalte wirkt er auch als Folie."
      right:
        trailId: "de/advisory/trails/stackit/getting-started"

    - role: sub
      id: "trail-step-types"
      title: "Die Schritt-Typen im Detail"
      trailContext: "Textschritte, Asset-Schritte und Seiten-Schritte, jeweils mit Beispiel."
      assetId: "advisory/assetcontainer/stackit/howto-trail-setup#step-configuration-types"

    - style: "chart"
      id: "present-trail"
      title: "Dein Trail ist auch ein Foliendeck"
      trailContext: "Mit vorbereiteten Ansichten und Sprechernotizen dient ein Trail einem Workshop und einem kurzen Briefing. Nichts zu exportieren, kein zweiter Foliensatz zu pflegen."
      splitRatio: 40
      left:
        text: "Klicke auf Präsentieren, und der Trail läuft als Deck: am Beamer, mit einem Klicker oder am Handy. Du siehst gerade eines."
      right:
        imageSrc: "contributors/stackit/core/getting_started/present-trail.png"
        imageAlt: "Das Präsentations-Icon oben rechts in einem geöffneten Trail"

    - style: "summit"
      id: "publish-trail"
      title: "Dein Teil endet mit dem Pull Request"
      trailContext: "Sobald der Pull Request offen ist, laufen Prüfungen, Vorschau und Merge ohne dich."
      splitRatio: 40
      left:
        text: "Setze im Pull Request den Haken für den automatischen Merge. Prüfungen, eine Vorschauseite für das Review und der Merge laufen dann ohne dich. Die öffentliche Seite zeigt die Änderung innerhalb von zwei Stunden."
      right:
        imageSrc: "contributors/stackit/core/contribution-flow.svg"
        imageAlt: "Dein Teil und der Teil, der ohne dich läuft: Fork, Dev-Container, hike, patrol, Pull Request, danach die automatischen Prüfungen und der Merge"

    - role: sub
      id: "trail-blueprint"
      title: "Ein vollständiger Trail als Vorlage"
      trailContext: "Der ganze scfTrail-Block, fertig zum Veröffentlichen."
      assetId: "advisory/assetcontainer/stackit/howto-trail-setup#production-frontmatter-blueprint"

  presentations:
    - id: new-contributor
      label: "Neuer Contributor (mit Profil-Setup)"
      description: "Die drei Stationen für einen ersten Beitrag: Profil, Asset und Trail."
      default: true
      steps:
        - id: overview
          role: hidden
          notes: "Setze den Rahmen mit dem Bild: drei Stationen, das Profil am Fuß, das Asset auf halber Höhe, der Trail am Gipfel. Das Studio hilft bei allen dreien."
        - id: create-profile
          notes: "Das Profil ist das öffentliche Gesicht: Name, Logo, kurze Beschreibung. Einmal angelegt, über einen normalen Pull Request."
        - id: asset-frontmatter
          notes: "Zeige auf die Karte rechts. Alles darauf kommt aus dem Metadatenblock. Nenne das Fenster von 150 bis 160 Zeichen für die Beschreibung; es zählt im Ranking."
        - id: studio
          role: sub
          notes: "Niemand muss die Metadaten von Hand schreiben. Zeige das Studio, wenn es geht: die Prüfungen laufen beim Tippen, und es öffnet den Pull Request."
        - id: configure-trail
          notes: "Trails machen aus einzelnen Assets eine Geschichte. Die Karte rechts ist die Tour durch die Seite, ein Trail wie jeder andere."
        - id: present-trail
          role: sub
          notes: "Der Meta-Moment: dieses Deck ist ein Trail. Vorbereitete Ansichten und Sprechernotizen erwähnen."
        - id: publish-trail
          role: sub
          notes: "Der Pull Request ist das Letzte, was sie tun. Nach Review und grünen Prüfungen übernimmt der automatische Merge."
    - id: existing-contributor
      label: "Vorhandener Contributor (ohne Profil-Setup)"
      description: "Für Contributors mit bestehendem Profil: direkt zu Assets und Trails."
      steps:
        - asset-frontmatter
        - id: studio
          role: sub
        - configure-trail
        - id: present-trail
          role: sub
        - publish-trail
    - id: overview
      label: "Überblick (nicht-technisch)"
      description: "Der Weg zum Beitrag im Überblick: Profil, Assets, Trails und Veröffentlichung, ohne Schema-Details."
      steps:
        - id: overview
          notes: "Jeder Contributor besitzt einen kleinen, klar abgegrenzten Bereich: ein Profil, seine Assets, seine Trails. Kein Beitrag kann das Material einer anderen Organisation berühren."
        - id: create-profile
          notes: "Das Profil ist das öffentliche Gesicht: Name, Logo, Beschreibung. Jedes Asset der Organisation verweist darauf zurück."
        - id: asset-frontmatter
          notes: "Jedes Asset trägt strukturierte Metadaten, und automatische Prüfungen halten sie einheitlich. Qualität sichert die Pipeline, nicht die Konvention."
        - id: studio
          role: sub
          notes: "Das eingebaute Studio schreibt gültige Dateien aus einem Formular. Die technische Einrichtung dient der Vorschau, sie ist keine Einstiegshürde."
        - id: configure-trail
          notes: "Trails sind das Produkt: Assets zu einer geführten Journey verbunden, der ein Kunde folgen kann."
        - id: present-trail
          role: sub
          notes: "Jeder Trail ist zugleich ein Foliendeck für Workshops und Reviews. Kein zweiter Foliensatz zu pflegen."
        - id: publish-trail
          notes: "Veröffentlicht wird über einen reviewten Pull Request: automatische Prüfungen plus ein menschliches Review vor jeder Änderung."
source_url: "https://framework.stackit.cloud/de/advisory/trails/stackit/scf-onboarding/"
source_file: "docs/de/advisory/trails/stackit/scf-onboarding.mdx"
---

## Steps

### 1. Drei Stationen zu deinem ersten Beitrag

Stage: `compass`

Ein Profil sagt, wer du bist. Assets tragen, was du weißt. Ein Trail macht daraus eine Journey. Das Studio hilft bei allen dreien.

### 2. Eine Seite stellt dich vor

Stage: `hut`

Eine Seite je Organisation oder Person, hinzugefügt über einen Pull Request wie jede andere Seite. Ein Review bringt sie online.

### 3. Wo deine Dateien liegen

Der Ordneraufbau für dein Profil, deine Assets und deine Logo-Dateien.

Asset: [/advisory/assetcontainer/stackit/howto-contributors/#directory-structure--asset-placement](/advisory/assetcontainer/stackit/howto-contributors/#directory-structure--asset-placement) — source: [/raw/advisory/assetcontainer/stackit/howto-contributors.md](/raw/advisory/assetcontainer/stackit/howto-contributors.md), section `#directory-structure--asset-placement`

### 4. Aus deinen Metadaten wird die Karte

Stage: `stairs`

Leser finden die Karte im Explorer, filtern danach und öffnen das Asset von dort.

### 5. Die Regeln für die Metadaten im Detail

Jedes Feld, seine Grenzen und die erlaubten Kategorien.

Asset: [/advisory/assetcontainer/stackit/howto-asset-integration/#strict-frontmatter-validation-schema](/advisory/assetcontainer/stackit/howto-asset-integration/#strict-frontmatter-validation-schema) — source: [/raw/advisory/assetcontainer/stackit/howto-asset-integration.md](/raw/advisory/assetcontainer/stackit/howto-asset-integration.md), section `#strict-frontmatter-validation-schema`

### 6. Das Studio schreibt die Metadaten für dich

Stage: `chairlift`

Das Studio läuft in deinem Dev-Container und auf der Dev-Seite. Es schreibt Profile, Assets, Trails und Framework-Seiten.

### 7. Ein Trail macht aus Assets eine Journey

Stage: `gondola`

Die Karte rechts ist die Tour durch die Seite, ein Trail, der genau so gebaut ist.

### 8. Die Schritt-Typen im Detail

Textschritte, Asset-Schritte und Seiten-Schritte, jeweils mit Beispiel.

Asset: [/advisory/assetcontainer/stackit/howto-trail-setup/#step-configuration-types](/advisory/assetcontainer/stackit/howto-trail-setup/#step-configuration-types) — source: [/raw/advisory/assetcontainer/stackit/howto-trail-setup.md](/raw/advisory/assetcontainer/stackit/howto-trail-setup.md), section `#step-configuration-types`

### 9. Dein Trail ist auch ein Foliendeck

Stage: `chart`

Mit vorbereiteten Ansichten und Sprechernotizen dient ein Trail einem Workshop und einem kurzen Briefing. Nichts zu exportieren, kein zweiter Foliensatz zu pflegen.

### 10. Dein Teil endet mit dem Pull Request

Stage: `summit`

Sobald der Pull Request offen ist, laufen Prüfungen, Vorschau und Merge ohne dich.

### 11. Ein vollständiger Trail als Vorlage

Der ganze scfTrail-Block, fertig zum Veröffentlichen.

Asset: [/advisory/assetcontainer/stackit/howto-trail-setup/#production-frontmatter-blueprint](/advisory/assetcontainer/stackit/howto-trail-setup/#production-frontmatter-blueprint) — source: [/raw/advisory/assetcontainer/stackit/howto-trail-setup.md](/raw/advisory/assetcontainer/stackit/howto-trail-setup.md), section `#production-frontmatter-blueprint`