Open Contributors
Zuletzt aktualisiert am
Open Contributors
Worum es geht
Abschnitt betitelt „Worum es geht“Die meisten Beiträge zum Framework kommen im Namen eines Unternehmens: ein Partner, ein STACKIT-Team, ein Dienstleister. Dessen Profil trägt das Logo, die Beschreibung und das Portfolio von allem, was es beiträgt.
Nicht jeder Beitrag entsteht so. Jemand verbessert in der eigenen Zeit eine Seite, der Arbeitgeber hat hier noch kein Profil, oder die Arbeit ist schlicht eine persönliche. Diesen Eintrag gibt es, damit solche Personen mit Namen genannt werden können, ohne eine Organisation zu erfinden, die sie nicht vertreten.
Was sich ändert und was nicht
Abschnitt betitelt „Was sich ändert und was nicht“Hier gelistet zu sein sagt genau eine Sache: Hinter diesem Beitrag steht kein Unternehmensprofil. Es sagt nichts über die Qualität der Arbeit und ändert nichts daran, wie ein Beitrag geprüft wird. Es laufen dieselben Prüfungen, es gilt dasselbe Review. Eine so beigetragene Seite steht im Framework wie jede andere.
Der Eintrag trägt auch kein Firmenzeichen. Die Seite zeigt statt eines Logos den neutralen Grat, weil es keine Marke zu zeigen gibt.
Assets und Trails unter diesem Eintrag
Abschnitt betitelt „Assets und Trails unter diesem Eintrag“Das ist ein vollwertiger Contributor-Slug, kein geringerer. Assets und Trails können unter assetcontainer/open-contributors/ und trails/open-contributors/ abgelegt werden, genau wie unter jedem Unternehmen. Sie erscheinen in den Explorern, den Loadern und der Suche wie alles andere.
Wichtig ist nur, wie die Nennung funktioniert, wenn sich viele einen Eintrag teilen. Ein Unternehmenseintrag steht für einen Contributor, also trägt das Profil die Nennung allein. Hier geht das nicht, denn mehrere Personen legen unter demselben Slug ab. Diese Aufgabe übernimmt der maintainers-Block jeder Seite: Trag dich mit user: dein.username ein, dann nennt dich die Seite. Das steht über der Git-Historie, die ohnehin festhält, wer was geschrieben hat.
Ein späterer Umzug ist ein Verschieben von Dateien. Sobald deine Organisation ein Profil hat, wandern ihre Seiten in ihren Container und die Nennung folgt.
Wann stattdessen ein Unternehmensprofil passt
Abschnitt betitelt „Wann stattdessen ein Unternehmensprofil passt“- Dein Arbeitgeber hat hier schon ein Profil: Nutze seinen Slug in deiner Erklärung. Beiträge werden dann dem Unternehmen zugeschrieben, was meist beide Seiten wollen.
- Dein Arbeitgeber hat noch kein Profil: Leg es an. Ein Contributor-Profil ist eine normale Seite im Content-Repository. Es nimmt denselben Weg über Fork und Pull Request wie jeder andere Beitrag und bekommt dasselbe Review. Ein Unternehmensprofil bringt mehr als ein geteilter Eintrag: eine eigene Seite und ein Portfolio, das jedes Asset und jeden Trail sammelt. Das Logo folgt separat, sobald Framework Core die Markenfreigabe erfasst hat.
- Du trägst als Person bei: Dann ist dieser Eintrag der richtige.
So wirst du gelistet
Abschnitt betitelt „So wirst du gelistet“Öffne im Content-Repository ein Issue Contributor declaration und gib open-contributors als Organisation an. Framework Core oder ein Framework Owner erfasst es. Ab dann nennt dich die Seite so, wie du es freigegeben hast.