In diesem Artikel lesen Sie,

• was hinter der Tutorial-Trophy-Initiative steckt,
• wie Sie ihr IT-Wissen in bare Münze umwandeln
• und welche Guidelines Sie dafür beachten müssen.

Wie funktionieren Deployment-Frameworks wie Ansible, Terraform oder Heat? Welche Best Practices vereinfachen das Arbeiten mit einer CI/CD-Pipeline? Welche Tipps und Tricks helfen beim Einstieg in die Microservice-Architektur? In der Community der Open Telekom Cloud teilen Nutzer und Experten ihr IT-Wissen rund um das Thema Cloud Computing, diskutieren Best Practices und unterstützen sich gegenseitig bei technischen Herausforderungen.

Ausführliche Tutorials zu gefragten IT-Themen sind für die Community besonders wertvoll. Wer dieses Wissen mitbringt und teilt, kann damit ab sofort etwas Geld verdienen: Das Engagement, anderen Nutzern, Entwicklern oder Administratoren den alltäglichen Einsatz der Public Cloud zu vereinfachen, würdigt die Telekom jetzt mit barer Münze. Für technische Tutorials erhalten Autoren künftig 300 Euro Honorar. Wie das geht und was es dabei zu beachten gilt, erklärt Nils Magnus, Cloud-Architekt bei der Open Telekom Cloud, im Interview.

In der Community schlummert ein gewaltiges Potenzial. Schließlich sind dort unzählige Experten aktiv, die sich mit vielen Cloud-Themen extrem gut auskennen. Wir möchten dazu beitragen, dass Nutzer ihr wertvolles Wissen untereinander teilen. Das ist ganz im Sinne des Open-Source-Gedankens, der unserer Open Telekom Cloud zugrunde liegt: Sie basiert auf OpenStack.

Wer ein Tutorial verfasst, hilft damit anderen sehr. Doch so eine Anleitung schreibt sich natürlich nicht von selbst. Schließlich haben unsere Community-Mitglieder vermutlich mehr als genug mit ihren täglichen Aufgaben zu tun. Wir wissen, dass ein Tutorial zu verfassen, Aufwand bedeutet. Mit der Tutorial-Trophy-Initiative schaffen wir einen zusätzlichen Anreiz, Cloud-Wissen mit anderen zu teilen, indem wir Anwender für ihren zusätzlichen Aufwand honorieren.

Das geht ganz einfach. Interessierte Autoren schicken eine kurze Beschreibung ihrer Tutorial-Idee. Unser Redaktionsteam prüft die Idee. Ist sie geeignet und relevant für die Community, kann es losgehen. Als erstes schließen wir mit den Autoren dann eine Honorarvereinbarung. Anschließend schreibt der Autor seine Idee auf. Sobald der Text fertig ist, sichten wir die Inhalte. Sind sie korrekt und vollständig, veröffentlichen wir die Anleitungen in der Open Telekom Cloud Community. Als Dankeschön gibt’s ein Honorar in Höhe von 300 Euro für den Verfasser.

Nein, nicht unbedingt. Grundsätzlich freuen wir uns über jedes Thema, das den Alltag anderer User erleichtert. Dennoch sehen wir Themen, die in der Community zurzeit besonders wichtig sind. Da geht es häufig um Themen wie Automatisierung und Infrastructure-as-Code. Best Practices bei der Entwicklung und dem Testen in Cloud-Umgebungen stehen genauso hoch im Kurs wie das Orchestrieren von Containern. Leser interessieren sich darüber hinaus aktuell besonders für Tutorials zu IT-Trends wie Machine Learning, Künstliche Intelligenz, Internet of Things und Edge Computing.

Ein nutzerfreundliches Tutorial ist in erster Linie leicht verständlich und gut strukturiert. Zwischenüberschriften geben einem Text beispielsweise eine gute Übersicht. Screenshots, Tabellen oder Diagramme machen Beispiele anschaulicher. Dabei sollten Bildunterschriften nicht fehlen, die beschreiben, was genau auf dem Bild zu sehen ist und warum es hier gezeigt wird. Denn ein Bild allein spricht selten für sich. Wer seinen Text schreibt, sollte außerdem möglichst kurze und aktive statt passiver Sätze verfassen.

Ideal sind Texte mit einer Länge zwischen 5.000 und 15.000 Zeichen (inklusive Leerzeichen). Und wir akzeptieren jedes Text- und Dateiformat, aber Texte in Markdown oder Restructured Text erleichtern uns die Arbeit. Die wichtigsten Tipps und Best Practices für das Schreiben von Tutorials haben wir außerdem auf der Tutorial-Trophy-Seite zusammengestellt.

Eine gelungene Struktur hilft den Lesern sehr. Der Einstieg liefert den übergeordneten Kontext des Tutorials und eine gute Beschreibung der Herausforderungen, die der Autor mit dem Tutorial lösen möchte, sowie eine kurze Zusammenfassung der grundlegenden Vorgehensweise. Der Lösungsweg selbst sollte den Hauptteil der Anleitung ausmachen. Hier ist es wichtig, dass der Autor seinen Lesern Schritt für Schritt das Vorgehen erklärt. Und am Ende sollte eine kurze Zusammenfassung mit der wichtigsten Botschaft nicht fehlen.