Questions fréquentes

Phase actuelle:
Développement de la documentation. Consultez le calendrier.

Questions d'ordre général

Google Season of Docs est-il un programme de recrutement ?

Non. Si vous souhaitez travailler chez Google, consultez le site Web de recrutement et d'offres d'emploi de Google.

Notre organisation voudrait participer à Google Season of Docs, mais nous ne savons pas par où commencer.

Consultez notre liste complète d'idées de projet ! Vous pouvez également vous adresser à la communauté des rédacteurs techniques (essayez la

de la saison des documents

Écrivez le Slack Docs ou sur vos réseaux sociaux pour demander de l'aide ou des propositions).

Quels types de projets les organisations peuvent-elles proposer ?

Voici quelques idées :

  • Créer un site de documentation sur une plate-forme qui sera décidée par le rédacteur technique et l'organisation Open Source, et publier un premier ensemble de documents de base sur le site. Voici quelques exemples de plates-formes:

  • Refactorisez la documentation existante du projet Open Source pour offrir une expérience utilisateur améliorée ou une architecture de l'information plus accessible.

  • Présentez un produit ou une fonctionnalité, ou rédigez une présentation conceptuelle. Souvent, une équipe crée sa documentation technique de bas en haut, ce qui génère beaucoup de détails, mais il est difficile de comprendre le produit dans son ensemble. Un rédacteur technique peut résoudre ce problème.

  • Créez un tutoriel pour un cas d'utilisation important.

  • Créez un ensemble de guides d'utilisation dédiés à des tâches spécifiques.

  • Créez un guide du contributeur comprenant des informations de base sur les premiers pas en tant que contributeur d'un projet Open Source, ainsi que des règles concernant les contrats de licence, les processus de demandes d'extraction et d'examen, la création du projet, etc.

Une vidéo peut-elle faire l'objet d'un projet pour Google Season of Docs ?

Oui. Assurez-vous que les exigences de la vidéo sont bien définies, et gardez à l'esprit que la production d'une vidéo de haute qualité nécessite beaucoup de temps et de ressources.

Un audit de la documentation est-il un projet raisonnable pour Google Season of Docs ?

Un audit de la documentation est un excellent projet pour Google Season of Docs. Tenez compte de la quantité de documentation dont vous disposez déjà. Si vous en avez beaucoup, vous devrez peut-être en réduire le champ d'application (par exemple, simplement vérifier le contenu du tutoriel). Si vous ne disposez que de peu ou pas de documentation, vous pouvez inclure la création de la documentation manquante ayant la priorité la plus élevée dans le cadre de votre projet.

Existe-t-il des modèles de documentation que les entreprises et les rédacteurs techniques peuvent utiliser ?

Google Season of Docs comporte un dépôt GitHub avec un modèle et une checklist pour effectuer des audits de la documentation. D'autres modèles seront ajoutés au fur et à mesure de leur création.

Le projet Good Docs travaille actuellement à la création de modèles de documentation au minimum viable pour l'Open Source.

Les organisations sont-elles tenues d'utiliser les documents produits par des rédacteurs techniques ?

Non. Il peut arriver que les projets ne se déroulent pas comme prévu ou que les exigences changent. Nous n'obligeons pas les organisations à utiliser la documentation ou les autres documents produits, mais nous nous attendons à ce que l'évaluation finale et l'étude de cas comprenne une discussion sur les raisons pour lesquelles la documentation n'a pas été utilisée et sur la manière dont le projet a pris la décision de ne pas utiliser la documentation ou d'autres supports.

Où la saison Google Docs est-elle disponible ?

La saison des documents Google se déroule entièrement en ligne. Il n'est pas nécessaire de voyager dans le cadre du programme.

Comment puis-je me tenir informé à propos de Google Season of Docs ?

Consultez la liste de diffusion des annonces sur season-of-docs-announce pour découvrir les dernières informations et annonces concernant Google Season of Docs. Rejoignez le groupe pour recevoir des informations par e-mail.

Puis-je ajouter la chronologie des saisons de Google Docs à mon agenda ?

Accédez à http://goo.gle/2NeZVew pour vous abonner à l'agenda de la saison des documents Google.

Que puis-je faire pour faire connaître Google Season of Docs ?

Vous pouvez tweeter à propos du programme, rédiger des articles de blog, publier des vidéos, ou organiser une rencontre ou une session d'information dans votre région. Nous mettons à votre disposition des exemples de contenus et de ressources que vous pouvez utiliser à distribuer à votre communauté (organisation, groupe de rédacteurs et autres contacts).

Comment organiser ou organiser une session d'information ou une rencontre Google Season of Docs ?

Vous pouvez planifier une rencontre à l'heure et au lieu qui vous conviennent. Consultez les règles du programme et utilisez l'exemple de contenu.

Pouvez-vous partager des statistiques sur les programmes 2019 et 2020 ?

Oui. Vous pouvez consulter les résultats de la saison Google Docs pour le programme 2019 sur le blog Open Source de Google (2019, 2020).

Vais-je recevoir un t-shirt Google Season of Docs ?

Non, en raison de contraintes d'expédition internationales, Google Season of Docs n'est plus en mesure de fournir des t-shirts aux participants qui terminent leur projet Google Season of Docs avec succès.

Que dois-je faire si j'ai d'autres questions ?

Consultez le guide pour les administrateurs en organisation et le guide du rédacteur technique.

Si vous n'avez toujours pas de réponse après avoir lu toute la documentation, envisagez de poser vos questions à la communauté Season of Docs de Google sur la liste de discussion. Consultez les informations concernant les canaux de discussion et découvrez comment nous contacter.

Comment puis-je devenir mentor pour Google Season of Docs ?

Google Season of Docs n'a pas de rôle de mentor officiel. Les organisations doivent spécifier comment les rédacteurs techniques seront intégrés et soutenus, et comment leurs contributions à la documentation seront examinées et approuvées dans le cadre de leur candidature. Si vous souhaitez accompagner des rédacteurs techniques dans le cadre de Google Season of Docs, contactez les administrateurs de votre organisation pour qu'ils soient bénévoles.

La saison des documents Google est-elle semblable à Google Summer of Code ?

Non. La fonctionnalité Google Season of Docs s'adresse aux personnes ayant une certaine expérience de la rédaction technique. Elle n'est pas conçue comme un programme de mentorat comme Google Summer of Code.

Pour les rédacteurs techniques

Quand les rédacteurs techniques pourront-ils s'inscrire pour bénéficier de la saison des documents Google ?

Google Season of Docs ne dispose pas d'une application de rédacteur technique officielle. Pour participer à Google Season of Docs en tant que rédacteur technique, contactez directement les organisations Open Source en suivant les instructions figurant sur la page du programme Google Season of Docs. Vous pouvez également faire part de votre intérêt en vous ajoutant à l'annuaire des rédacteurs techniques Google Season of Docs. Pour en savoir plus, consultez le guide du rédacteur technique.

Quels outils et frameworks de documentation dois-je connaître pour participer à Google Season of Docs ?

Les outils et frameworks de documentation que vous utiliserez dépendent de l'organisation avec laquelle vous souhaitez travailler. L'un des objectifs de Google Season of Docs est que les projets Open Source aident les rédacteurs techniques à en savoir plus sur les outils et les frameworks impliqués dans la documentation des produits Open Source. Pour cette raison, il n'est généralement pas nécessaire de connaître précisément des plates-formes de documentation spécifiques avant de commencer votre projet Google Season of Docs.

Cela dit, la plupart des organisations Open Source utilisent un certain type de Markdown ou un autre langage de balisage pour leur documentation. Nous vous recommandons d'identifier le langage utilisé par l'organisation de votre choix et de vous familiariser avec la syntaxe. Markdown est un bon début, car les fichiers README de GitHub utilisent un type de Markdown. Consultez le guide GitHub relatif au Markdown.

Déterminez si l'organisation que vous avez choisie héberge déjà sa documentation sur un site Web et, si oui, quelle plate-forme elle utilise. La plate-forme peut être un générateur de site statique tel que Jekyll, Sphinx ou Hugo, ou l'organisation peut héberger ses documents sur Lire la documentation ou les pages GitHub. Une fois que vous avez identifié la plate-forme utilisée par l'organisation, explorez et testez le langage et le framework appropriés. Cela vous permet de démarrer rapidement avec votre projet Open Source et de fournir des conseils avisés pour le projet Open Source de votre choix.

Quel(s) langage(s) de programmation dois-je connaître pour participer à des projets Google Season of Docs ?

Selon la nature de votre projet de documentation, vous devrez peut-être connaître un langage de programmation. Tenez-en compte lorsque vous choisissez et proposez un projet de documentation, et consultez l'organisation Open Source pour connaître le niveau de familiarité requis.

Les rédacteurs techniques travaillant déjà sur un projet Open Source peuvent-ils continuer à travailler dessus dans le cadre de la saison des documents Google ?

Oui, mais l'organisation doit noter la relation précédente ou actuelle du rédacteur technique avec le projet dans sa proposition.

Quels sont les critères d'éligibilité pour participer ?

Ai-je besoin d'une expérience ou d'une formation préalable en tant que rédacteur technique ?

Une expérience ou une formation préalable en rédaction ou en rédaction technique est préférable, mais pas essentielle. Lorsque vous soumettez une déclaration d'intérêt à une organisation, vous pouvez décrire votre expérience ou toute formation que vous avez suivie en rédaction technique. Vous devriez être en mesure de fournir des preuves prouvant votre intérêt pour la documentation technique ou Open Source, y compris des exemples de documentation que vous avez rédigée. L'organisation Open Source recherchera des rédacteurs techniques ayant le niveau d'expérience dont elle a besoin pour s'assurer de la réussite de ses projets Google Season of Docs.

Serai-je payé pour ma participation à la saison des documents Google ?

Oui. Google accordera des subventions aux organisations acceptées pour qu'elles puissent employer des rédacteurs techniques.

À quoi ressemble une bonne déclaration d'intérêt d'un rédacteur technique ?

Les meilleures déclarations d'intérêt sont celles de rédacteurs techniques qui prennent le temps d'interagir avec l'organisation Open Source de leur choix et de discuter de leurs idées avant de soumettre leurs propres déclarations. Consultez le guide pour créer une déclaration d'intérêt.

Combien de temps prend la participation à la saison des documents Google ?

La taille des projets varie, mais va de 5 à 30 heures par semaine pendant le programme. Cependant, le temps passé dépend de la nature du projet sur lequel vous vous êtes mis d'accord avec votre organisation. Avant de vous engager, vous devez évaluer le projet et discuter d'une estimation de temps avec l'organisation Open Source.

Puis-je envoyer une demande d'inscription d'une organisation afin de créer des documents pour un projet Open Source en tant que particulier ? J'aimerais créer une série d'articles de blog, de vidéos ou d'autres documents sur la façon d'utiliser un projet ou un outil open source, mais je n'en fais pas partie ou y contribue.

Non, vous ne devez soumettre une proposition que si vous pouvez recevoir des fonds au nom du projet Open Source. Si vous souhaitez participer à un projet, contactez les responsables du projet et collaborez sur une proposition de candidature.

Je suis élève. Puis-je participer à Google Season of Docs ? Le programme Google Season of Docs m'apprendra-t-il à devenir rédacteur technique ?

Les étudiants peuvent travailler avec les organisations acceptées, mais Google Season of Docs n'est pas destiné à enseigner des compétences en rédaction technique. Les rédacteurs techniques participants doivent avoir des compétences professionnelles de rédaction technique ou une expérience pertinente équivalente. Les élèves qui souhaitent participer doivent mettre en avant leurs expériences pertinentes de rédaction et d'édition lorsqu'ils postulent.

Puis-je participer à la fois en tant que rédactrice technique à Google Season of Docs et en tant qu'étudiante à Google Summer of Code ?

Nous déconseillons aux nouveaux contributeurs ou étudiants acceptés de participer au programme Google Summer of Code de postuler pour devenir rédacteur technique pour Google Season of Docs.

La saison de Google Docs n'est pas destinée aux débutants. Elle s'adresse aux personnes possédant déjà de solides compétences et une expérience de rédaction technique. Les rédacteurs techniques dans Google Season of Docs ne sont pas encadrés. Ils doivent être auto-organisés et motivés pour élaborer leur plan d'attaque du projet de l'organisation avec un minimum de conseils de la part des administrateurs de l'organisation et des autres membres de la communauté.

En tant que rédacteur technique, comment puis-je contacter les administrateurs du programme Google Season of Docs de Google si j'ai d'autres questions ou préoccupations ?

Vous pouvez contacter les administrateurs du programme Google Season of Docs en leur envoyant un e-mail à l'adresse season-of-docs@google.com.

Une société de rédaction technique ou de conseil peut-elle participer à Google Season of Docs ?

Oui, une entreprise peut faire appel à une entreprise pour effectuer le travail décrit dans sa proposition.

Comment faire référence à Google Season of Docs sur mon CV ?

Énumérez-le comme vous le feriez pour n'importe quel autre travail indépendant: "J'ai travaillé en tant que rédacteur technique pour [nom du projet] dans le cadre du programme Google Season of Docs".

Fournissez-vous des certificats de réussite pour votre participation à Google Season of Docs ?

Google Season of Docs ne peut pas envoyer de certificats ni de confirmations de participation au projet aux rédacteurs techniques.

Pour les administrateurs d'organisations Open Source

Quels sont les critères d'éligibilité pour bénéficier d'une organisation Open Source ?

Pour pouvoir participer en tant qu'organisation, vous devez être un groupe exécutant un projet logiciel libre ou Open Source actif, tel que BRL-CAD. Il n'est pas nécessaire que le projet soit une entité juridiquement constituée. Les organisations doivent avoir déjà produit et publié un logiciel sous une licence Open Source Initiative approuvée. Elles doivent également compter au moins deux contributeurs comme administrateurs pour l'ensemble du programme Google Season of Docs afin de participer au programme.

Consultez également les critères d'éligibilité décrits dans les Règles du programme et dans la section Programmes de sanctions et informations sur les pays du Trésor des États-Unis.

Le terme "organisation" est-il l'équivalent d'un projet Open Source ?

Une organisation peut avoir un ou plusieurs projets Open Source. Certaines organisations, telles que les fondations, peuvent comporter plusieurs sous-organisations comportant chacune un ou plusieurs projets Open Source. Si votre organisation comporte des sous-organisations indépendantes, soumettez des demandes et des propositions distinctes pour chacune d'elles.

Une entreprise peut-elle soumettre plusieurs demandes de propositions ?

Non. N'envoyez qu'une demande par organisation. Si votre organisation possède des sous-organisations (par exemple, si elle est une fondation qui gère de nombreux projets Open Source individuels), chaque projet doit soumettre sa propre demande, même si les fonds de la subvention sont gérés par l'organisation mère.

Un groupe de projets Open Source peut-il soumettre une proposition pour travailler sur un seul projet de documentation ?

Une organisation doit soumettre la demande de proposition et être responsable de la coordination du travail et de l'assistance provenant des autres projets participants. Par exemple, un groupe de petits projets Open Source qui sont tous des plug-ins d'un projet plus important et qui souhaitent travailler sur un guide d'utilisation commun pour créer des plug-ins doit choisir une organisation pour diriger le projet.

Comment mon organisation recevra-t-elle les fonds ?

Pour recevoir des fonds, votre organisation doit disposer d'un compte Open Collective.

Les organisations reçoivent-elles de l'argent en échange de leur participation à Google Season of Docs ?

Les organisations peuvent inclure des fonds pour l'administration, le mentorat ou l'examen du travail dans le cadre du budget de leurs projets.

Est-ce que Google prend en charge les frais de traitement des paiements ?

Les frais de traitement des paiements ne sont pas pris en charge par Google, car ils ont tendance à varier en fonction du mode de paiement. Toutefois, Google prend en charge les frais de plate-forme Open Collective, et si vous décidez d'utiliser Open Collective en tant qu'hôte fiscal, ces frais sont également pris en charge. Pour en savoir plus, consultez le Guide sur l'obtention d'autorisations d'accès.

Comment mon organisation doit-elle budgétiser les coûts d'un rédacteur technique ?

Nous vous recommandons de consulter Écrire l'enquête sur les salaires Docs et de calculer les taux horaires. Vous pouvez également rejoindre la chaîne Write The Docs Slack et demander aux rédacteurs techniques intéressés de participer sur la chaîne #season-of-docs.

Mon organisation peut-elle utiliser la subvention Google Season of Docs pour payer un contributeur actuel ?

Oui. Toutefois, les propositions de projet doivent concerner de nouveaux travaux (y compris des tâches de maintenance, de révision ou de mise à niveau de la documentation existante). Vous ne pouvez pas demander d'autorisation pour payer un travail déjà terminé.

Mon organisation peut-elle collaborer avec des élèves rédacteurs techniques ?

Vous pouvez demander à des élèves de rédacteurs techniques de travailler sur votre projet. Si vous décidez de travailler avec des élèves, nous vous recommandons vivement de limiter votre participation aux élèves qui:

  • ont plus de 18 ans ;
  • être inscrits à un cours ou à un programme de rédaction technique ou de communication technique ;
  • Avoir un accès démontré au mentorat de rédaction technique dans le cadre de son programme ou de son cours

Mon organisation peut-elle collaborer avec plusieurs rédacteurs techniques ?

Votre entreprise peut sélectionner et payer plusieurs rédacteurs techniques, mais tous les rédacteurs techniques travaillant avec votre organisation doivent travailler sur le projet que vous avez proposé. La collaboration avec plusieurs rédacteurs techniques ajoutera plus de complexité à votre projet et nécessitera plus de bénévolat et de temps d'administration.

Mon organisation peut-elle faire appel à une société de rédaction technique pour travailler sur notre projet ?

Oui, votre organisation peut engager une société de rédaction technique pour travailler sur votre projet. Assurez-vous que l'entreprise que vous embauchez peut être payée par Open Collective.

Notre rédacteur technique a abandonné le programme avant la fin du programme. Notre organisation peut-elle toujours recevoir les fonds restants ?

Il est fortement recommandé d'essayer de trouver un nouveau rédacteur technique pour le mener à bien avant la fin du programme. Toutefois, le versement des fonds restants n'est pas basé sur l'achèvement du projet, mais sur la réalisation de l'étude de cas et de l'évaluation finale.

Si votre projet n'a pas pu être mené à bien, votre étude de cas doit en examiner les raisons. Par exemple, vous avez peut-être constaté que vos outils de documentation sont très complexes et se sont avérés un obstacle à l'intégration d'un rédacteur technique, ou que votre projet implique des tests et des mises à jour de tutoriels et nécessitait une grande expérience en codage. Que recommanderiez-vous à d'autres projets, sur la base de votre expérience ? Incluez ces informations dans votre étude de cas.

Les candidatures d'une organisation peuvent-elles être examinées avant la date limite d'envoi ?

Malheureusement, la saison des documents Google n'est pas en mesure de fournir des commentaires sur l'application de l'organisation.

Comment les entreprises doivent-elles définir la portée de leurs propositions de projet ?

Lorsque vous développez des idées de projet, essayez d'identifier les plus petits projets qui apporteront de la valeur à l'organisation (mais qui peuvent être étendus si le temps le permet). Plus petit, mieux c'est. Lorsque vous créez votre proposition de projet, nous vous recommandons de vous en tenir à des projets plus petits et plus détaillés plutôt qu'à des projets plus importants qui sont moins spécifiés. Si votre projet nécessite une grande expertise dans le domaine, essayez d'inclure des projets qui pourraient être étudiés par une personne sans cette expérience.

Puis-je participer en tant qu'administrateur d'une organisation à Google Season of Docs et en tant que mentor pour Google Summer of Code ?

Oui. Google Season of Docs et Google Summer of Code sont des programmes distincts. Si vous avez la bande passante requise pour participer aux deux programmes, ce n'est pas un problème.

Notre organisation a participé à des programmes précédents de la saison des documents Google. Notre organisation peut-elle postuler à nouveau ?

Oui, les organisations qui ont participé à des programmes Google Season of Docs précédents peuvent à nouveau postuler.

Données archivées

Comment supprimer mes informations des archives Google Season of Docs ?

Contactez-nous pour demander la suppression de vos informations.