Häufig gestellte Fragen

Aktuelle Phase:
Das Docs-Programm 2021 endete am 14. Dezember 2021. Siehe Zeitachse.

Allgemein

Ist Google Season of Docs ein Recruiting-Programm?

Nein. Wenn Sie für Google arbeiten möchten, besuchen Sie die Google Jobs-Website.

Welche Änderungen gibt es bei der Google Season of Docs 2021?

Die Google Season of Docs 2021 hat im Vergleich zu den Vorjahren einige wichtige Änderungen:

  • Technische Redakteure bewerben sich nicht mehr über Google um Abgleich mit Organisationen
  • Organisationen reichen im Rahmen ihrer Bewerbung Projektvorschläge ein, einschließlich des Budgets und der vorgeschlagenen Metriken.
  • Akzeptierte Organisationen erhalten Zuschüsse, mit denen sie technische Redakteure bezahlen.
  • Organisationen reichen abschließende Bewertungen und Fallstudien ein

Warum hat Google Season of Docs diese Änderungen vorgenommen?

Google hat es sich zur Aufgabe gemacht, die Informationen dieser Welt zu organisieren und sie allgemein zugänglich und nutzbar zu machen. Wir hoffen, dass wir mit der neuen Ausrichtung von Google Season of Docs, bei der es vor allem um effektive Dokumentationspraktiken in Open Source geht, langfristig einen größeren Einfluss haben werden.

Unsere Organisation möchte an der Season of Docs 2021 teilnehmen, weiß aber nicht, wo sie anfangen soll.

Hier finden Sie eine vollständige Liste unserer Projektideen. Sie können sich auch an die Community für technisches Schreiben wenden. Versuchen Sie es mit dem Kanal #season-of-docs in der Write the Docs Slack-Community oder in Ihren Social-Media-Kanälen, um Hilfe oder Vorschläge zu erhalten.

Welche Arten von Projekten können Organisationen vorschlagen?

Hier einige Vorschläge:

  • Erstellen Sie eine Dokumentationswebsite auf einer Plattform, die vom technischen Redakteur und der Open-Source-Organisation festgelegt wird, und veröffentlichen Sie eine erste Reihe grundlegender Dokumente auf der Website. Beispiele für Plattformen:

  • Die vorhandene Dokumentation des Open-Source-Projekts refaktorieren, um eine verbesserte Nutzererfahrung oder eine zugänglichere Informationsarchitektur zu bieten.

  • Schreiben Sie einen konzeptionellen Überblick über oder eine Einführung in ein Produkt oder eine Funktion. Oft erstellt ein Team seine technische Dokumentation von unten nach oben. Das führt dazu, dass es viele Details gibt, aber das Produkt als Ganzes schwer zu verstehen ist. Ein Technischer Redakteur kann das Problem beheben.

  • Erstellen Sie eine Anleitung für einen bekannten Anwendungsfall.

  • Erstellen Sie eine Reihe von Anleitungen für bestimmte Aufgaben.

  • Erstellen Sie einen Leitfaden für Mitwirkende, der grundlegende Informationen zum Einstieg als Mitwirkender am Open-Source-Projekt sowie alle Regeln zu Lizenzvereinbarungen, Prozessen für Pull-Requests und Überprüfungen, zum Erstellen des Projekts usw. enthält.

Ist ein Video ein mögliches Projekt für die Google-Staffel der Dokumente?

Ja. Achte darauf, dass die Videoanforderungen gut definiert sind und dass die Produktion eines qualitativ hochwertigen Videos viel Zeit und Ressourcen in Anspruch nimmt.

Ist eine Dokumentationsprüfung ein angemessenes Projekt für die Google Season of Docs?

Eine Dokumentationsprüfung ist ein tolles Projekt für die Google Season of Docs. Achten Sie darauf, wie viel Dokumentation Sie bereits haben. Wenn Sie viele haben, müssen Sie möglicherweise den Umfang reduzieren (z. B. nur die Prüfung des Anleitungsinhalts). Wenn Sie nur wenig oder gar keine Dokumentation haben, sollten Sie die Erstellung der fehlenden Dokumentation mit der höchsten Priorität in Ihr Projekt aufnehmen.

Gibt es Dokumentationsvorlagen für Organisationen und technische Redakteure?

Google Season of Docs hat ein GitHub-Repository mit einer Vorlage und Checkliste für die Durchführung von Dokumentenprüfungen. Wir werden nach und nach weitere Vorlagen hinzufügen.

Das Good Docs Project arbeitet an der Erstellung von Vorlagen für Minimum Viable Documentation für Open Source.

Müssen Organisationen die von technischen Redakteuren erstellten Dokumente verwenden?

Nein. Gelegentlich laufen Projekte nicht wie erwartet ab oder die Anforderungen ändern sich. Organisationen müssen die erstellte Dokumentation oder andere Materialien nicht verwenden. Wir erwarten jedoch, dass die endgültige Bewertung und Fallstudie eine Erläuterung dazu enthält, warum die Dokumentation nicht verwendet wurde und wie die Entscheidung getroffen wurde, die Dokumentation oder andere Materialien nicht zu verwenden.

Wo findet die Google Season of Docs statt?

Die Google-Saison der Dokumente findet ausschließlich online statt. Im Rahmen des Programms ist keine Reise erforderlich.

Wie kann ich über die Google Season of Docs auf dem Laufenden bleiben?

Auf der Mailingliste season-of-docs-announce finden Sie die neuesten Updates und Ankündigungen zu Google Season of Docs. Treten Sie der Gruppe bei, um Updates per E-Mail zu erhalten.

Kann ich die Google-Zeitleiste für die Google-Saison der Dokumente zu meinem Kalender hinzufügen?

Ja, du kannst sie über diesen Link hinzufügen.

Was kann ich tun, um die Google Season of Docs bekannter zu machen?

Sie können über das Programm twittern, Blogbeiträge verfassen, Videos veröffentlichen oder ein Treffen oder eine Informationsveranstaltung in Ihrer Nähe veranstalten. Wir haben einige Beispielinhalte und -ressourcen zusammengestellt, die du für deine Community (Organisation, Autorengruppe und andere Kontakte) verwenden kannst.

Wie kann ich eine Informationsveranstaltung oder ein Meetup zu Google Season of Docs organisieren oder veranstalten?

Sie können einen Termin zu einer beliebigen Zeit und an einem beliebigen Ort vereinbaren. Bitte lesen Sie die Programmregeln und verwenden Sie die Beispielinhalte.

Gibt es Statistiken zu den Seasons of Docs 2019 und 2020?

Ja, die Ergebnisse der Google Season of Docs für das Programm 2019 können hier und die Ergebnisse des Programms 2020 hier eingesehen werden.

Erhalte ich ein T-Shirt von Google Season of Docs?

Nein. Aufgrund von Einschränkungen beim internationalen Versand können wir Teilnehmern, die ihr Google Season of Docs-Projekt erfolgreich abgeschlossen haben, keine T-Shirts mehr zur Verfügung stellen.

Ich habe weitere Fragen. Was kann ich tun?

Weitere Informationen finden Sie im Administratorhandbuch für Organisationen und im technischen Leitfaden für Autoren.

Wenn Sie nach dem Lesen der gesamten Dokumentation immer noch keine Antwort gefunden haben, können Sie Ihre Fragen in der Diskussionsliste mit der Google Season of Docs-Community besprechen. Weitere Informationen zu Diskussionskanälen und zur Kontaktaufnahme

Wie kann ich Mentor für Google Season of Docs werden?

Bei der Google Season of Docs 2021 gibt es keine formelle Mentorrolle. Organisationen sollten angeben, wie technische Redakteure in das Team aufgenommen und unterstützt werden und wie ihre Dokumentationsbeiträge im Rahmen des Antrags der Organisation geprüft und genehmigt werden. Wenn Sie im Rahmen von Google Season of Docs als Mentor für technische Redakteure tätig werden möchten, empfehlen wir Ihnen, sich an die Administratoren Ihrer Organisation zu wenden, um sich als Freiwilliger zu melden.

Ist Google Season of Docs mit Google Summer of Code vergleichbar?

Nein. Google Season of Docs richtet sich an Personen mit Erfahrung im technischen Schreiben und ist kein Mentoring-Programm wie Google Summer of Code.

Für technische Redakteure

Wann können sich technische Redakteure für die Google-Saison der Dokumente bewerben?

Für die Google Season of Docs 2021 gibt es keine formelle Bewerbung für Technische Redakteure. Wenn Sie als Technischer Redakteur an der Google Season of Docs 2021 teilnehmen möchten, wenden Sie sich direkt an die Open-Source-Organisationen. Folgen Sie dazu der Anleitung auf der Programmseite der Season of Docs. Sie können auch Ihr Interesse bekunden, indem Sie sich in das Season of Docs-Verzeichnis für technische Redakteure eintragen. Weitere Informationen finden Sie im Leitfaden für technische Redakteure.

Welche Dokumentationstools und ‑frameworks sollte ich kennen, um an der Google Season of Docs teilzunehmen?

Welche Dokumentationstools und ‑frameworks Sie verwenden, hängt von der Organisation ab, für die Sie arbeiten möchten. Ein Ziel der Google Season of Docs besteht darin, dass die Open-Source-Projekte technischen Redakteuren helfen, mehr über die Tools und Frameworks zu erfahren, die bei der Dokumentation von Open-Source-Produkten zum Einsatz kommen. Aus diesem Grund ist es in der Regel nicht erforderlich, dass Sie detailliertes Wissen über bestimmte Dokumentationsplattformen haben, bevor Sie mit Ihrem Google Season of Docs-Projekt beginnen.

Die meisten Open-Source-Organisationen verwenden jedoch eine Variante von Markdown oder eine andere Markup-Sprache für ihre Dokumentation. Wir empfehlen Ihnen, herauszufinden, welche Sprache die von Ihnen ausgewählte Organisation verwendet, und sich mit der Syntax vertraut zu machen. Markdown ist ein guter Ausgangspunkt, da GitHub-README-Dateien eine Variante von Markdown verwenden. Weitere Informationen finden Sie im GitHub-Leitfaden zu Markdown.

Finden Sie heraus, ob die von Ihnen ausgewählte Organisation ihre Dokumentation bereits auf einer Website hostet und falls ja, welche Plattform sie verwendet. Die Plattform kann ein Generator für statische Websites wie Jekyll, Sphinx oder Hugo sein. Die Organisation kann ihre Dokumente auch auf Read the Docs oder GitHub Pages hosten. Sobald Sie wissen, welche Plattform die Organisation verwendet, sollten Sie sich mit der entsprechenden Sprache und dem entsprechenden Framework vertraut machen und damit experimentieren. So können Sie schnell mit Ihrem Open-Source-Projekt beginnen und fundierte Ratschläge für das Open-Source-Projekt Ihrer Wahl geben.

Welche Programmiersprache(n) sollte ich kennen, um an Projekten der Google Season of Docs teilzunehmen?

Je nach Art Ihres Dokumentationsprojekts müssen Sie möglicherweise mit einer Programmiersprache vertraut sein. Berücksichtigen Sie dies bei der Auswahl und dem Vorschlag eines Dokumentationsprojekts und erkundigen Sie sich bei der Open-Source-Organisation nach dem erforderlichen Kenntnisstand.

Können technische Redakteure, die bereits an einem Open-Source-Projekt arbeiten, im Rahmen der Google Season of Docs weiter daran arbeiten?

Ja, aber das Unternehmen sollte in seinem Angebot die frühere oder anhaltende Beziehung des technischen Redakteurs zum Projekt vermerken.

Welche Voraussetzungen gelten für die Teilnahme?

Benötige ich Vorkenntnisse oder eine Ausbildung als technischer Redakteur?

Vorkenntnisse oder eine Ausbildung im technischen Schreiben sind wünschenswert, aber nicht unbedingt erforderlich. Wenn Sie einer Organisation ein Interessenbekenntnis senden, können Sie Ihre Erfahrung und/oder Ausbildung im technischen Schreiben beschreiben. Sie sollten Nachweise dafür erbringen können, dass Sie sich für technische Dokumentation oder Open-Source-Dokumentation interessieren, einschließlich Beispiele für von Ihnen verfasste Dokumentationen. Die Open-Source-Organisation sucht nach technischen Redakteuren mit der entsprechenden Erfahrung, um die Google Season of Docs-Projekte erfolgreich abzuschließen.

Werde ich für die Teilnahme an der Google Season of Docs bezahlt?

Ja. Google vergibt Zuschüsse an die ausgewählten Organisationen, die sie für die Einstellung von technischen Redakteuren verwenden können.

Wie sieht eine gute Interessenbekundung für technische Redakteure aus?

Die besten Interessenbekundungen stammen von technischen Redakteuren, die sich die Zeit nehmen, mit der von ihnen ausgewählten Open-Source-Organisation zu interagieren und ihre Ideen mit ihr zu besprechen, bevor sie ihre Interessenbekundungen einreichen. Weitere Informationen finden Sie im Leitfaden zum Erstellen einer Interessenbekundung.

Wie lange dauert die Teilnahme an der Google Season of Docs?

Die Projektgröße variiert, aber während des Programms sind 5 bis 30 Stunden pro Woche erforderlich. Wie viel Zeit Sie dafür aufwenden, hängt jedoch von der Art des Projekts ab, das Sie mit Ihrem Unternehmen vereinbart haben. Bevor Sie sich festlegen, sollten Sie das Projekt bewerten und mit der Open-Source-Organisation einen Zeitplan besprechen.

Kann ich als Einzelperson einen Antrag für eine Organisation einreichen, um Dokumentationen für ein Open-Source-Projekt zu erstellen? Ich möchte eine Reihe von Blogposts, Videos oder anderen Materialien zur Verwendung eines Open-Source-Projekts oder -Tools erstellen, aber ich bin nicht an dem Projekt beteiligt und kann auch nicht daran mitwirken.

Nein, Sie sollten nur dann einen Vorschlag einreichen, wenn Sie die Möglichkeit haben, Finanzmittel für das Open-Source-Projekt zu erhalten. Wir empfehlen Ihnen, sich an das Projekt zu wenden und gemeinsam an einem Antrag zu arbeiten.

Ich bin Student. Kann ich an der Google Season of Docs 2021 teilnehmen? Lerne ich bei Google Season of Docs, technische Dokumentationen zu schreiben?

Schüler und Studenten können mit akzeptierten Organisationen zusammenarbeiten. Die Google-Saison der Dokumente ist jedoch nicht dafür vorgesehen, technische Schreibfähigkeiten zu vermitteln. Wir erwarten, dass teilnehmende technische Redakteure über professionelle technische Schreibfähigkeiten oder entsprechende Erfahrungen verfügen. Studierende, die teilnehmen möchten, sollten ihre relevanten Erfahrungen im Schreiben und Bearbeiten hervorheben, wenn sie sich an interessierte Organisationen und Projekte wenden.

Kann ich sowohl als Technischer Redakteur an Google Season of Docs als auch als Student an Google Summer of Code teilnehmen?

Auch wenn dies derzeit nicht gegen die Regeln verstößt, empfehlen wir Studenten, die für Google Summer of Code angenommen wurden, sich nicht als technischer Redakteur für Google Season of Docs zu bewerben. Studenten sollten sich auf die Arbeit für Google Summer of Code konzentrieren, anstatt sich für Google Season of Docs zu bewerben.

Außerdem richtet sich Google Season of Docs nicht an Anfänger, sondern an Personen, die bereits gute bis sehr gute Kenntnisse und Erfahrung im technischen Schreiben haben. Technische Redakteure in Season of Docs erhalten kein Mentoring. Stattdessen müssen sie selbstorganisiert und motiviert sein, ihren Plan für die Umsetzung des Projekts der Organisation mit minimaler Unterstützung von den Administratoren der Organisation und anderen Community-Mitgliedern zu entwickeln.

Wie kann ich mich als Technischer Redakteur an die Google-Programmadministratoren von Google Season of Docs wenden, wenn ich weitere Fragen oder Bedenken habe?

Sie können sich per E-Mail an die Google Season of Docs-Programmadministratoren wenden: season-of-docs@google.com.

Kann ein Unternehmen oder eine Beratungsfirma für technisches Schreiben an der Season of Docs teilnehmen?

Ja, ein Unternehmen kann ein Unternehmen damit beauftragen.

Wie kann ich Season of Docs in meinem Lebenslauf erwähnen?

Geben Sie sie wie jede andere freiberufliche Tätigkeit an, z.B. „Im Rahmen des Season of Docs-Programms als Technischer Redakteur für [Name des Projekts] gearbeitet“.

Stellen Sie Abschlusszertifikate für die Teilnahme an der Google Docs-Saison vor?

Wir können technischen Redakteuren keine Zertifikate oder Bestätigungen der Projektteilnahme senden.

Für Open-Source-Organisationsadministratoren

Welche Eignungsvoraussetzungen gelten für eine Open-Source-Organisation?

Um als Organisation teilnehmen zu können, müssen Sie eine Gruppe sein, die ein aktives Free-/Open-Source-Softwareprojekt betreibt, z. B. BRL-CAD. Das Projekt muss keine rechtsfähigen Rechtssubjekte sein. Organisationen müssen bereits Software gemäß einer von der Open Source Initiative genehmigten Lizenz entwickelt und veröffentlicht haben und mindestens zwei Mitwirkende haben, die als Administratoren der Organisation für das gesamte Google Season of Docs-Programm fungieren.

Weitere Informationen zu den Teilnahmevoraussetzungen finden Sie in den Programmrichtlinien und den Sanktionsprogrammen und Länderinformationen des US-Finanzministeriums.

Ist „Organisation“ mit einem Open-Source-Projekt gleichzusetzen?

Eine Organisation kann ein oder mehrere Open-Source-Projekte haben. Einige Organisationen, z. B. Stiftungen, haben möglicherweise mehrere untergeordnete Organisationen, die jeweils ein oder mehrere Open-Source-Projekte haben. Wenn Ihre Organisation unabhängige Unterorganisationen hat, reichen Sie bitte für jede Unterorganisation separate Anträge und Vorschläge ein.

Kann eine Organisation mehrere Bewerbungen einreichen?

Nein. Reichen Sie bitte nur einen Antrag pro Organisation ein. Wenn Ihre Organisation untergeordnete Organisationen hat (z. B. eine Stiftung mit vielen einzelnen Open-Source-Projekten), sollte jedes Projekt einen eigenen Antrag einreichen, auch wenn die Fördergelder von der Dachorganisation verwaltet werden.

Kann eine Gruppe von Open-Source-Projekten gemeinsam einen Vorschlag einreichen, um an einem einzigen Dokumentationsprojekt zu arbeiten?

Eine Organisation sollte den Antrag einreichen und für die Koordination der Arbeit und Unterstützung durch andere teilnehmende Projekte verantwortlich sein. (Zum Beispiel sollte eine Gruppe kleiner Open-Source-Projekte, die alle Plug-ins für ein größeres Projekt sind und an einem gemeinsamen Leitfaden zum Erstellen von Plug-ins arbeiten möchten, eine Organisation auswählen, die das Projekt leitet.)

Wie erhält meine Organisation die Zahlungen?

Damit deine Organisation Spenden erhalten kann, benötigt sie ein Open Collective-Konto.

Erhalten Organisationen eine Vergütung für die Teilnahme an der Google Season of Docs?

Organisationen können Finanzmittel für Verwaltung, Mentoring oder Überprüfung der Arbeit als Teil ihres Projektbudgets anbieten.

Wie sollte meine Organisation die Kosten für einen technischen Redakteur kalkulieren?

Wir empfehlen, sich die Write the Docs-Gehaltsumfrage anzusehen und Stundensätze zu berechnen. Sie können auch der Slack-Dokumentation „Write The Docs“ beitreten und interessierten technischen Redakteuren über den Kanal #season-of-docs darum bitten, Gebote abzugeben.

Kann meine Organisation den Google Season of Docs-Zuschuss verwenden, um einen aktuellen Mitwirkenden zu bezahlen?

Ja. Projektvorschläge müssen jedoch für neue Arbeiten gelten (einschließlich Wartungsarbeiten, Überarbeitungen oder Upgrades einer vorhandenen Dokumentation). Sie dürfen keinen Zuschuss beantragen, der für bereits abgeschlossene Arbeiten verwendet werden soll.

Kann meine Organisation mit technischen Studierenden zusammenarbeiten?

Sie können technische Redakteure ausbilden, die an Ihrem Projekt arbeiten. Wenn Sie mit Schülern und Studenten arbeiten, sollten Sie die Teilnahme auf folgende Personen beschränken:

  • Sie sind über 18 Jahre alt.
  • Sie sind in einem Programm oder Kurs für technisches Schreiben oder technische Kommunikation eingeschrieben.
  • Sie haben nachweislich Zugang zu einer Mentorschaft für technisches Schreiben über ihr Programm oder ihren Kurs.

Kann meine Organisation mit mehr als einem technischen Redakteur zusammenarbeiten?

Ihre Organisation kann mehrere Technische Redakteure auswählen und bezahlen, aber alle Technischen Redakteure, die mit Ihrer Organisation zusammenarbeiten, müssen an dem von Ihnen vorgeschlagenen Projekt arbeiten. Die Zusammenarbeit mit mehreren technischen Redakteuren erhöht die Komplexität Ihres Projekts und erfordert mehr Zeit für die Organisation und Verwaltung.

Kann meine Organisation ein Unternehmen für technisches Schreiben beauftragen, an unserem Projekt zu arbeiten?

Ja, Ihre Organisation kann ein Unternehmen für technische Dokumentation beauftragen, an Ihrem Projekt zu arbeiten. Das von dir beauftragte Unternehmen muss über Open Collective bezahlt werden können.

Unser Technischer Redakteur ist vor Ende des Programms ausgestiegen. Haben wir trotzdem Anspruch auf das Restguthaben?

Wir empfehlen Ihnen dringend, vor Ende des Programms einen neuen technischen Redakteur zu finden, der Ihr Projekt abschließt. Die Auszahlung der verbleibenden Gelder erfolgt jedoch nicht nach Abschluss des Projekts, sondern nach Abschluss der Fallstudie und der abschließenden Bewertung.

Wenn Ihr Projekt nicht abgeschlossen werden konnte, sollten Sie in Ihrer Fallstudie erläutern, warum das der Fall war. Vielleicht haben Sie beispielsweise festgestellt, dass Ihre Dokumentationstools sehr kompliziert sind und das Onboarding eines technischen Redakteurs erschweren, oder dass Ihr Projekt das Testen und Aktualisieren von Anleitungen erfordert und umfangreiche Programmierkenntnisse voraussetzt. Was würden Sie anderen Projekten aufgrund Ihrer Erfahrung empfehlen? Fügen Sie diese Informationen in Ihre Fallstudie ein.

Kann ein Antrag einer Organisation vor dem Einreichtermin geprüft werden?

Leider können wir kein Feedback zum Antrag der Organisation geben.

Wie sollten Unternehmen den Umfang ihrer Projektvorschläge festlegen?

Versuchen Sie bei der Entwicklung von Projektideen, die kleinsten Projekte zu finden, die für das Unternehmen von Nutzen sind (aber bei ausreichender Zeit erweitert werden können). Je kleiner, desto besser. Bei der Erstellung Ihres Projektvorschlags empfehlen wir, sich auf kleinere, detailliertere Projekte zu konzentrieren, anstatt auf größere Projekte, die weniger genau angegeben sind. Wenn Ihr Projekt umfangreiche Fachkenntnisse erfordert, versuchen Sie, Projekte einzubeziehen, die von jemandem ohne diesen Hintergrund bearbeitet werden könnten.

Kann ich als Organisationsadministrator an der Google-Saison von Google Docs und als Mentor bei Google Summer of Code teilnehmen?

Ja. Die Google Season of Docs und Google Summer of Code sind separate Programme. Wenn Sie die Kapazität haben, um an beiden Programmen teilzunehmen, ist das in Ordnung.

Unsere Organisation hat bereits an früheren Google Season of Docs-Programmen teilgenommen. Können wir uns noch einmal bewerben?

Ja. Organisationen, die bereits an früheren Google Season of Docs-Programmen teilgenommen haben, können sich noch einmal bewerben.

Archivierte Daten

Wie entferne ich meine Informationen aus dem Google Season of Docs-Archiv?

Wenden Sie sich an uns, um Ihre Daten entfernen zu lassen.