Häufig gestellte Fragen

Aktuelle Phase:
Die Saison 2019 für Google Docs wurde am 6. März 2020 beendet. Siehe Zeitachse.

Allgemein

Ist „Season of Docs“ ein Rekrutierungsprogramm?

Nein. Wenn Sie bei Google arbeiten möchten, besuchen Sie die Jobs-Website von Google.

Gilt „Season of Docs“ als Praktikum, als Job oder in irgendeiner Form der Beschäftigung?

Nein. Die Staffel von Google Docs ist eine Aktivität, die der technische Redakteur als unabhängiger technischer Redakteur ausführt und für den er ein Gehalt erhält. Technische Autoren können den Erhalt des Stipendiums widerrufen.

Warum sollte ich an „Season of Docs“ teilnehmen?

Das Ziel von „Season of Docs“ ist die Förderung der Zusammenarbeit zwischen Open-Source-Organisationen und technischen Redakteuren. Wir gehen davon aus, dass dieses Programm:

  • Geben Sie technischen Redakteuren die Möglichkeit, Erfahrungen mit Beiträgen zu Open-Source-Projekten zu sammeln und mehr über Open-Source-Code zu erfahren.
  • Geben Sie Open-Source-Projekten die Möglichkeit, die Community für technische Texte einzubeziehen und damit die Open-Source-Dokumentation zu verbessern.
  • Auf Open-Source-Dokumente und technische Texte sensibilisieren.

Vorteile für Open-Source-Organisationen:

  • Erfahrung in der Zusammenarbeit mit einem technischen Redakteur.
  • Verbesserte Dokumente
  • Die Möglichkeit einer kontinuierlichen Zusammenarbeit mit technischen Redakteuren ist auch nach Ende der Google Docs-Saison möglich.
  • Verbesserte Prozesse zur Dokumentation von Projekten.
  • In der Community des technischen Schreibens wurde das Bewusstsein für Open-Source-Dokumente gestärkt.

Vorteile für technische Redakteure:

  • Erfahrung mit der Mitarbeit an einem Open-Source-Projekt
  • Erfahrung in der Arbeit mit entwicklerorientierten Dokumenten und mit Code
  • Anerkennung und Anerkennung für die geleistete Arbeit.
  • Etwas, das Sie Ihrem Lebenslauf hinzufügen können.
  • Die Möglichkeit einer kontinuierlichen Zusammenarbeit mit dem Open-Source-Projekt
  • Ein wachsendes Bewusstsein für den Mehrwert, den technische Redakteure bringen können, ist in Open-Source-Communitys gestiegen.

Welche Arten von Projekten können technische Redakteure angehen?

Hier einige Vorschläge:

  • Erstellen Sie auf einer Plattform eine Dokumentationswebsite, die vom technischen Autor und Open-Source-Mentor ausgewählt wird, und veröffentlichen Sie erste grundlegende Dokumente auf der Website. Beispiele für Plattformen:

  • Refaktorieren Sie die vorhandene Dokumentation des Open-Source-Projekts, um die Nutzerfreundlichkeit zu verbessern oder die Informationsarchitektur besser zugänglich zu machen.

  • Schreiben Sie eine konzeptionelle Übersicht oder Einführung in ein Produkt oder eine Funktion. Oft erstellt ein Team seine technische Dokumentation von Grund auf neu. Das Ergebnis sind zwar viele Details, aber das Produkt als Ganzes lässt sich nur schwer verstehen. Ein technischer Redakteur kann dieses Problem beheben.

  • Erstellen Sie ein Tutorial für einen bekannten Anwendungsfall.

  • Sie erstellen eine Reihe gezielter Anleitungen für bestimmte Aufgaben.

  • Erstellen Sie einen Leitfaden für Beitragende, der grundlegende Informationen zu den ersten Schritten als Mitwirkender am Open-Source-Projekt sowie Regeln zu Lizenzvereinbarungen, Prozessen für Pull-Anfragen und Überprüfungen, Erstellung des Projekts usw. enthält.

Ist ein Video ein mögliches Projekt für „Season of Docs“?

Ja. Die Open-Source-Organisation hat die Aufgabe, Projektideen zu veröffentlichen und einen Projektvorschlag von einem technischen Redakteur auszuwählen. Wenn ein Video die Anforderungen der Open-Source-Organisation erfüllt, können Sie es als „Season of Docs“-Projekt einreichen, sofern es sich um ein technisches Lehrvideo handelt. Achten Sie darauf, dass die Videoanforderungen gut abgegrenzt sind, und beachten Sie, dass die Produktion eines Videos in hoher Qualität Zeit und Ressourcen in Anspruch nimmt.

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

Nein. Wir hoffen zwar, dass die gesamte Dokumentation und der Code aus diesem Programm ein schönes Zuhause finden, aber wir verlangen, dass Organisationen die Dokumentation oder den Code der technischen Redakteure nicht verwenden.

Wo findet die Datei „Staffel von Dokumenten“ statt?

Die Staffel von Google Docs findet ausschließlich online statt. Sie müssen im Rahmen des Programms nicht reisen.

Wie kann ich mich über die Staffel von Google Docs informieren?

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

Wie kann ich andere auf Season of Docs aufmerksam machen?

Sie können über das Programm twittern, Blogposts schreiben, Videos veröffentlichen oder ein Treffen oder eine Informationssitzung in Ihrer Region veranstalten. Wir haben einige Beispielinhalte und -ressourcen, die Sie in Ihrer Community (Organisation, Autorengruppe und andere Kontakte) verwenden können.

Wie organisiere oder veranstalte ich eine Informationssitzung oder ein Treffen zur Staffel von Google Docs?

Sie können jederzeit einen Termin für ein Treffen vereinbaren. Sehen Sie sich die Programmregeln an und verwenden Sie den Beispielinhalt.

Kann ich an der Season of Docs sowohl als Mentor als auch als technischer Redakteur teilnehmen?

Nein. Wir möchten sicherstellen, dass jedes Projekt und jede technische Redakteurin ausreichend Aufmerksamkeit erhält, und wir sind der Meinung, dass dies zu einer schlechten Erfahrung für die beteiligten Personen führen könnte. Bitte wählen Sie aus, ob die Teilnahme als Mentor oder technischer Redakteur für Sie attraktiver ist, und planen Sie, sich entsprechend zu bewerben.

Erhalte ich ein "Season of Docs"-T-Shirt?

Ja. Teilnehmer an erfolgreich abgeschlossenen Projekten erhalten ein „Season of Docs“-T-Shirt. Das diesjährige T-Shirt ist das Eröffnungsprogramm-T-Shirt.

Wann kommt mein T-Shirt an?

Aufgrund der COVID-19-Situation können wir derzeit noch nicht abschätzen, wann du dein T-Shirt erhältst. Google hat einen Anbieter mit der Herstellung der T-Shirts und der Logistik für den weltweiten Versand beauftragt. Google-Programmadministratoren senden dir per E-Mail einen eindeutigen Zugriffscode, mit dem du den Stil und die Größe deines T-Shirts auswählen und deine Versanddetails eingeben kannst, sobald die Produktion möglich ist. Die Herstellung und der Versand der T-Shirts dauert in der Regel einige Wochen.

Ich habe weitere Fragen. Was kann ich tun?

Weitere Informationen finden Sie im Leitfaden für technische Autoren, im Leitfaden für Mentoren und im Leitfaden für Organisationsadministratoren.

Wenn Sie die gesamte Dokumentation gelesen haben und immer noch keine Antwort haben, können Sie Ihre Fragen mit der Season of Docs-Community auf Slack oder über die Diskussionsliste diskutieren. Weitere Informationen finden Sie unter Diskussionskanäle und Kontakt.

Für technische Redakteure

Wann können sich technische Redakteure für „Staffel von Google Docs“ bewerben?

Die Bewerbungsphase für technische Redakteure dauert vom 29. Mai 2019 bis zum 28. Juni 2019. Weitere Informationen finden Sie im Programmzeitplan und im Leitfaden für technische Autoren.

Welche Dokumentationstools und -rahmen sollte ich kennen, um an "Season of Docs" teilnehmen zu können?

Welche Dokumentationstools und Frameworks Sie verwenden, hängt von der Organisation ab, mit der Sie arbeiten möchten. Das Ziel von „Season of Docs“ ist, dass die Open-Source-Projekte technische Redakteure dabei unterstützen, mehr über die Tools und Frameworks für die Dokumentation von Open-Source-Produkten zu erfahren. Aus diesem Grund müssen Sie in der Regel keine detaillierten Kenntnisse über bestimmte Dokumentationsplattformen haben, bevor Sie mit dem Projekt "Season of Docs" beginnen.

Allerdings verwenden die meisten Open-Source-Organisationen Markdown oder eine andere Auszeichnungssprache für ihre Dokumentation. Finden Sie heraus, welche Sprache die von Ihnen gewählte Organisation verwendet, und machen Sie sich mit der Syntax vertraut. Markdown ist ein guter Anfang, da die 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 wenn ja, welche Plattform sie verwendet. Die Plattform kann ein statischer Websitegenerator wie Jekyll, Sphinx oder Hugo sein oder die Organisation kann ihre Dokumente auf Docs lesen oder GitHub-Seiten hosten. Wenn Sie herausgefunden haben, welche Plattform die Organisation nutzt, erkunden und experimentieren Sie mit der relevanten Sprache und dem entsprechenden Framework. Dies hilft Ihnen, schnell mit Ihrem Open-Source-Projekt zu beginnen, und bietet Ihnen die Möglichkeit, fundierte Ratschläge für das Open-Source-Projekt Ihrer Wahl zu geben.

Welche Programmiersprachen sollte ich beherrschen, um an „Season of Docs“ mitzuarbeiten?

Je nach Art Ihres Dokumentationsprojekts müssen Sie möglicherweise mit einer Programmiersprache vertraut sein. Berücksichtigen Sie dies, wenn Sie ein Dokumentationsprojekt auswählen und vorschlagen, und wenden Sie sich bezüglich des erforderlichen Vertrautheitsgrads an die Open-Source-Organisation.

Kann ich mehrere Projektvorschläge einreichen?

Ja, es wird jedoch nur ein Projektvorschlag pro technischem Redakteur angenommen. Weitere Informationen finden Sie in der Anleitung zum Erstellen Ihrer Anwendung.

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

Ja, aber Sie sollten in Ihrem Angebot Ihre vorherige Beziehung zu dem Projekt angeben.

Kann eine Gruppe gemeinsam ein Angebot einreichen, um an einem einzigen Projekt zu arbeiten?

Nein, an einem bestimmten Projekt darf nur eine Einzelperson arbeiten.

Kann ich mich direkt an die Mentoringorganisationen wenden, bevor ich einen Vorschlag für „Season of Docs“ einreiche?

Ja, du kannst direkt mit der Open-Source-Organisation, mit der du zusammenarbeiten möchtest, kommunizieren, bevor du deine Bewerbung für „Season of Docs“ einreichst. Die Open-Source-Mentoren können Ihnen helfen, Ihre Projektidee zu verfeinern.

Welche Teilnahmevoraussetzungen gelten für die Teilnahme?

  • Sie müssen mindestens 18 Jahre alt sein, wenn Sie sich registrieren.
  • Sie müssen berechtigt sein, in dem Land zu arbeiten, in dem Sie während des Programms leben.
  • Sie müssen in einem Land leben, das derzeit nicht gegen ein Embargo der USA verstößt. Weitere Informationen findest du in den Programmregeln und den Sanktionsprogrammen und Länderinformationen des US-Finanzministeriums.

Werden bei den Teilnahmevoraussetzungen für mich Ausnahmen gemacht?

Nein. Wir können keine Ausnahmen machen, wenn Sie die Teilnahmevoraussetzungen nicht erfüllen, unabhängig davon, wie talentiert oder interessiert Sie sind. Eine Ausnahme für Sie zu machen, wäre nicht fair gegenüber den anderen technischen Redakteuren, die die Teilnahme an „Season of Docs“ beantragen.

Welche Formulare muss ich einreichen?

Berechtigte Teilnehmer müssen entsprechende Steuerformulare einreichen.

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

Vorkenntnisse in technischem Schreiben oder in Schulungen sind von Vorteil, aber nicht unbedingt erforderlich. Wenn Sie einen Projektvorschlag einreichen, können Sie Ihre Erfahrungen und/oder Schulungen technisch beschreiben. Sie sollten Nachweise vorlegen können, die Ihr Interesse an der technischen oder Open-Source-Dokumentation belegen, einschließlich Beispielen für von Ihnen verfasste Dokumentation. Das Programm "Season of Docs" zielt auf eine Partnerschaft mit erfahrenen oder in Schulungen beschäftigten technischen Redakteuren mit Open-Source-Mentoren ab, damit beide voneinander lernen können. Die Open-Source-Organisation sucht nach technischen Redakteuren mit der entsprechenden Erfahrung, um den erfolgreichen Abschluss ihrer „Season of Docs“-Projekte zu gewährleisten.

Werde ich für die Teilnahme an „Season of Docs“ bezahlt?

Ja. Google vergibt ein Stipendium an technische Redakteure, die das Programm erfolgreich abschließen. Sie können den Erhalt des Stipendiums auch deaktivieren. Weitere Informationen finden Sie im Artikel Stipendium für technische Autoren.

Erhalte ich auch dann Einnahmen, wenn die Organisation meine Dokumentation oder meinen Code nicht verwendet?

Ja, vorausgesetzt, Ihr Projekt besteht die abschließende Bewertung durch den Open-Source-Mentor. Auf die Auszahlung des Stipendiums für technische Autoren hat das Open-Source-Projekt keinen Einfluss darauf, ob die erstellte Dokumentation oder der erstellte Code verwendet wird.

Wie sieht ein guter Vorschlag für technische Redakteure aus?

Die besten Vorschläge stammen von technischen Redakteuren, die sich die Zeit nehmen, mit der jeweiligen Open-Source-Organisation zu diskutieren und ihre Ideen zu besprechen, bevor sie ihre Bewerbungen für das Programm "Season of Docs" einreichen. Weitere Informationen finden Sie in der Anleitung zum Erstellen Ihrer Anwendung.

Wie lange dauert die Teilnahme an der saisonalen Präsentation von Google Docs?

Wie viel Zeit Sie dafür aufwenden müssen, hängt von der Art des Projekts ab, das Sie mit Ihrer beratenden Organisation vereinbart haben. Die Anzahl der Stunden ist bewusst flexibel, um unterschiedliche Projektarten und Arbeitsstile zu berücksichtigen.

Bevor Sie Ihren Projektvorschlag einreichen, sollten Sie das Projekt bewerten und eine Zeitschätzung mit der Open-Source-Organisation besprechen. Wenn es Ihnen aufgrund anderer Verpflichtungen schwerfällt, die vereinbarte Zeit aufzuwenden, haben Sie die Möglichkeit, das Projekt in einem längeren Zeitraum abzuschließen und trotzdem das Stipendium und die Bestätigung der geleisteten Arbeit zu erhalten. Geben Sie beim Einreichen Ihres Antrags auf „Season of Docs“ die Option für ein Projekt mit langer Laufzeit an.

Ich studiere im Bereich der technischen Kommunikation, habe aber noch keine Berufserfahrung. Kann ich trotzdem teilnehmen?

Ja. Geben Sie bei der Einreichung Ihres Projektvorschlags im Abschnitt mit den Vorkenntnissen Ihre Universitäts- oder Hochschulkurse an.

Ich bin in den USA als Student mit F1-Visum zugelassen. Wie erhalte ich die Autorisierung zur Teilnahme?

Weitere Informationen erhalten Sie von der zuständigen Behörde für Studentenangelegenheiten Ihrer Bildungseinrichtung. Google kann Ihnen keine CPT- oder OPT-Autorisierung erteilen.

Alle angenommenen Teilnehmer erhalten eine Bestätigungs-E-Mail. Wir bieten keine benutzerdefinierten Buchstaben an.

Wie verwendet Season of Docs die Informationen aus meinem Antragsformular?

Die Google-Programmadministratoren leiten einige Informationen aus Ihrer Anwendung an die Administratoren der ausgewählten Open-Source-Organisation weiter, damit die Organisation Ihren Projektvorschlag bewerten kann.

Wenn Ihr Projekt in das Programm aufgenommen wird, veröffentlicht „Season of Docs“ die Projektdetails auf der Website.

Eine Beschreibung der Datennutzung findest du im Leitfaden zum Antragsformular für technische Redakteure.

Für Open-Source-Mentoren und Organisationsadministratoren

Ich möchte mehr über die Teilnahme als Mentor bei „Season of Docs“ erfahren. Wo erhalte ich weitere Informationen?

Im Leitfaden für Mentoren und in den Programmrichtlinien finden Sie weitere Informationen dazu, wie Sie Mentor für die Saison werden.

Welche Teilnahmevoraussetzungen gelten für eine Mentoring-Organisation?

Um als Mentoring-Organisation teilnehmen zu können, müssen Sie eine Gruppe sein, die ein aktives kostenloses/Open-Source-Softwareprojekt wie BRL-CAD anführt. Das Projekt muss keine rechtsgültige Rechtspersönlichkeit sein. Mentoringorganisationen müssen bereits Software unter einer von der Open-Source-Initiative genehmigten Lizenz produziert und veröffentlicht haben und mindestens zwei Mitwirkende als Organisationsadministratoren und/oder Mentoren für das gesamte Season of Docs-Programm haben, um am Programm teilnehmen zu können.

Beachten Sie auch die Teilnahmevoraussetzungen, die in den Programmregeln und den Sanktionsprogrammen und Länderinformationen des US-Finanzministeriums beschrieben sind.

Erhalten Organisationen Geld für die Teilnahme an „Season of Docs“?

Organisationen mit einwandfreiem Status erhalten am Ende des Programms ein Stipendium pro zugelassener technischer Redakteur. Dabei spielt es keine Rolle, ob das Projekt des technischen Redakteurs erfolgreich ist oder nicht. Organisationen können diese Mittel nach Belieben verwenden.

Wie vergeben die Google-Programmadministratoren Zeitblöcke für technische Schreibprojekte?

Für das Pilotprojekt von „Season of Docs“ im Jahr 2019 sind insgesamt maximal 50 Projekte zum technischen Schreiben zulässig.

Als Richtlinie gehen wir davon aus, dass wir maximal zwei Projekte pro Organisation akzeptieren, damit es nicht zu viele Projekte gibt. Wenn bei der kostenlosen Auswahl jedoch nicht alle Slots belegt sind, können die Programmadministratoren von Google einigen Organisationen zusätzliche Slots zuweisen.

Wenn Sie Ihre Auswahl an Projekten für das technische Schreiben senden, können Sie daher mehr als zwei Projekte auswählen. Die ausgewählten Elemente müssen nach Priorität geordnet werden, wobei die höchste Priorität oben in der Liste steht.

In Ihrer Kommunikation mit den technischen Redakteuren sollten Sie deutlich machen, dass das Projekt erst angenommen wird, wenn die Google-Programmadministratoren die Liste der akzeptierten Projekte auf der Programmwebsite veröffentlichen.

Kann ich sowohl als Organisationsadministrator als auch als Mentor an Season of Docs teilnehmen?

Ja. Der Administrator einer Organisation kann auch als Mentor fungieren. Sie müssen kein separates Formular für Mentoren ausfüllen. Beim Ausfüllen des Antragsformulars für die Organisation oder des alternativen Administratorformulars sollten Sie die Option in diesem Formular verwenden, um anzugeben, dass Sie auch als Mentor fungieren.

Kann ich als Organisationsadministrator oder Mentor sowohl an Season of Docs als auch an Google Summer of Code teilnehmen?

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

Kann ich als Organisationsadministrator oder Mentor sowohl an Season of Docs als auch an Google Code-in teilnehmen?

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

Archivierte Daten

Wie entferne ich meine Informationen aus dem Archiv der Staffel von Google Docs?

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