Article original : How to Crack the Google Season of Docs Application Process for 2020

Par Edidiong Asikpo

Au fil des années, des enquêtes ont montré l'importance d'une bonne documentation dans la manière dont les développeurs choisissent et utilisent l'open source.

Lors de l'édition inaugurale du Google Season of Docs (GSoD) en 2019, le programme a reçu près de 450 candidatures de rédacteurs techniques et plus de 50 rédacteurs techniques ont été acceptés.

En tant que l'un des rédacteurs techniques acceptés pour participer au programme Google Season of Docs, j'ai pensé partager quelques conseils sur la manière de se préparer et de créer une candidature solide pour le programme GSoD.

Table des matières

Qu'est-ce que le Google Season of Docs ?
Qui est éligible pour participer au programme ?
Avantages de la participation
5 conseils pour réussir votre candidature GSoD
Mon expérience GSoD
Ressources utiles

Qu'est-ce que le Google Season of Docs ?

Season of Docs est un programme annuel organisé par Google. Son objectif est de réunir des rédacteurs techniques et des organisations open source pour favoriser la collaboration et l'amélioration de la documentation dans l'espace Open Source.

Cette initiative est extrêmement importante car la documentation d'un projet Open Source offre une voie aux utilisateurs non seulement pour comprendre le projet, mais aussi pour y contribuer.

Pendant le programme, les rédacteurs techniques acceptés passent entre 3 et 5 mois à construire un nouvel ensemble de documents, à améliorer la structure des documents existants, à développer un tutoriel très nécessaire, ou à améliorer les processus de contribution et les guides d'une organisation Open Source.

Qui est éligible pour participer au programme ?

Selon les règles de Google, vous devez avoir au moins 18 ans au moment de l'inscription. Vous devez également avoir une expérience préalable en tant que rédacteur technique et être éligible pour travailler dans votre pays de résidence.

Si vous répondez à ces qualifications, vous pouvez alors postuler pour participer au programme Google Season of Docs.

Avantages de la participation

Il y a de nombreux avantages à participer au programme Season of Docs. En voici quelques-uns :

Vous pouvez recevoir une bourse

Après avoir terminé le programme Google Season of Docs, vous recevez une bourse de Google. Il est important de noter que cette bourse est facultative, vous devez donc indiquer que vous souhaitez être payé pendant la phase de candidature.

Le montant de la bourse est calculé en fonction de votre localisation. Voir ici pour plus de détails sur les bourses.

Vous améliorez vos compétences

Un autre avantage évident de participer au programme Google Season of Docs est qu'il vous permet d'améliorer vos compétences en tant que rédacteur technique.

Vous élargissez votre réseau

Outre l'amélioration de vos compétences en tant que rédacteur technique, vous avez également l'opportunité de travailler avec des personnes qui font des choses incroyables dans l'espace Open Source.

Dans mon cas, j'ai eu l'opportunité de travailler avec l'organisation VideoLAN, ce qui signifiait que je devais travailler en étroite collaboration avec le président de l'organisation et les principaux contributeurs des projets.

Vous pouvez obtenir des recommandations et des références

Lors de la candidature à un emploi, avoir une bonne lettre de recommandation aide souvent à renforcer votre candidature.

Travailler en étroite collaboration avec un mentor sur le projet Season of Docs présente une opportunité de sécuriser une riche source de recommandations et de références.

Vous accédez à de futures opportunités

Si vous êtes prêt à postuler pour un rôle de rédacteur technique chez Google, inclure votre expérience Season of Docs dans votre CV vous donne plus d'avantages par rapport aux autres candidats.

Vous devenez un contributeur Open Source

Outre tous les avantages mentionnés précédemment, participer au programme Season of Docs signifie que vous contribuez à des projets Open Source. Cela aide le monde à démystifier le stéréotype selon lequel les contributions Open Source sont uniquement destinées aux développeurs de logiciels.

5 conseils pour réussir votre candidature GSoD

Voici 5 conseils pour vous aider à préparer et à créer une candidature solide pour le programme Season of Docs.

Créez et publiez des articles sur votre blog

L'un des critères les plus importants pour être accepté en tant que rédacteur technique dans le programme Google Season of Docs est la capacité à montrer que vous avez une expérience préalable en écriture.

Google et les mentors proposés du projet sur lequel vous souhaitez travailler doivent être convaincus que vous êtes la bonne personne pour travailler sur le projet. Cela signifie qu'ils veulent voir un bon nombre de documentations et d'articles bien écrits que vous avez créés.

Heureusement, il n'est pas trop tard pour créer un blog ou publier plus de contenu sur votre blog déjà existant.

Si vous avez déjà un blog, c'est une bonne idée de publier plus d'articles bien écrits avant, pendant et après avoir soumis votre proposition. Si vous n'avez pas de blog, il n'est toujours pas trop tard pour en créer un en utilisant Hashnode's Devblog ou votre plateforme préférée et publier des articles bien écrits également.

Choisissez le bon projet Open Source

Honêtement, je ne peux pas trop insister sur l'importance de choisir le bon projet Open Source. Cela est crucial car cela joue un rôle fort dans votre acceptation dans le programme.

Voici mes réflexions sur le choix du bon projet :

Parcourez tous les projets approuvés et essayez de sélectionner au moins 5 projets qui vous intéressent.
Après avoir sélectionné au moins 5 projets, parcourez-les à nouveau et réduisez les projets à un maximum de 3 projets et un minimum de 2 projets.
Bien qu'il puisse être raisonnable de se concentrer sur un seul projet pendant la phase de candidature, je vous encourage à postuler pour au moins deux projets afin d'améliorer vos chances d'être accepté pour au moins un projet.
Pour chaque projet que vous choisissez, rejoignez le canal de communication de l'organisation et faites savoir aux responsables du projet votre intérêt pour ce projet. Ainsi, vous pourrez établir une relation entre vous et le mentor. Notez également que les mentors ne choisissent pas les personnes uniquement parce qu'elles ont les compétences nécessaires. Ils sélectionnent également les candidats parce qu'ils croient pouvoir travailler avec eux. Donc, lorsque vous envoyez un message à un mentor, soyez explicite sur ce dont vous avez exactement besoin et, surtout, ne vous énervez pas s'ils ne répondent pas immédiatement, car la plupart des mentors sont des bénévoles qui ont d'autres emplois à temps plein.
Ne attendez pas qu'on vous donne tout. Effectuez beaucoup de recherches sur le projet. Découvrez et comprenez tout ce que vous devez savoir et si vous avez des préoccupations, contactez le mentor proposé de ce projet pour obtenir de l'aide ou demandez à d'autres membres de cette communauté.
Plus important encore, notez tout ce que vous découvrez pendant vos recherches et qui sera utile si vous êtes accepté pour travailler sur le projet ou des informations qui aideront à améliorer votre proposition.

Rédigez une proposition

Beaucoup de gens ne le savent pas, mais rédiger une proposition est vital. Cela vous donne une compréhension claire de l'objectif du projet, du temps qu'il vous faudra pour le compléter, de ce que vous devez savoir, et ainsi de suite.

Outre cela, rédiger une proposition montre également à votre mentor vos objectifs pour le projet, pourquoi vous pensez être la bonne personne pour le rôle, votre expérience, les échéanciers du projet, et plus encore.

Après avoir rédigé votre proposition, envoyez-la au mentor du projet pour révision. Leur révision vous aidera à connaître les exigences du projet du point de vue du mentor. J'ai ajouté un lien vers ma proposition pour le Google Season of Docs dans la section Ressources.

Faites au moins une contribution à l'organisation Open Source

Le programme Season of Docs n'est pas comme le Google Summer of Code où vous devez faire au moins une contribution au projet Open Source qui vous intéresse. Mais faire une contribution peut définitivement améliorer vos chances d'être accepté, alors essayez de le faire.

Restez actif dans la communauté après la date limite de candidature

Après avoir soumis votre candidature, essayez de rester actif dans cette organisation Open Source. Cela montre aux mentors que vous êtes passionné par ce projet et par cette communauté Open Source en général.

Mon expérience GSoD

Lors du programme GSoD de l'année dernière, j'ai eu l'opportunité de travailler avec l'organisation VideoLAN sur le projet Moderniser (réécrire) la documentation utilisateur de VLC.

Après que ma proposition a été acceptée par l'organisation VideoLAN, mes mentors et moi avons convenu des objectifs que je devais atteindre pendant le programme Google Season of Docs.

Voici mes objectifs :

Restructurer la documentation.
Mettre à jour la documentation pour qu'elle corresponde aux versions modernes de VLC.
Migrer la documentation utilisateur vers Gitlab en utilisant Sphinx et ReadtheDocs.
Supprimer les images et informations obsolètes.
Réécrire la documentation utilisateur pour la rendre facile à comprendre.
La configurer pour la traduction en utilisant l'internationalisation de Sphinx.

J'ai appris beaucoup plus sur l'organisation VideoLAN et VLC, j'ai découvert que VLC a plus de fonctionnalités que je ne connaissais pas, et j'ai appris à utiliser la plateforme de documentation Sphinx et à restructurer du texte.

Mes compétences en rédaction technique se sont également considérablement améliorées. Dans l'ensemble, participer au programme Google Season of Docs a été l'une des meilleures choses qui me soient arrivées en 2019.

Ressources utiles

Voici une liste de ressources utiles pour vous aider à en savoir plus sur le programme Season of Docs et la rédaction technique.

Vous aimez cet article ? Suivez @Didicodes sur Twitter.