Phase actuelle:
Développement de la documentation. Consultez le calendrier.
Cette page contient des questions à prendre en compte lors de la création d'un accord avec un rédacteur technique pour Google Season of Docs. Il ne s'agit pas d'un conseil juridique ni d'une liste exhaustive de tous les points possibles à prendre en compte lors de la création d'accords techniques pour la rédaction de projets Open Source. En fonction des besoins de votre organisation ou de votre projet, vous pouvez consulter votre propre conseiller juridique avant d'intégrer un rédacteur technique.
Types de tâches
- Dressez la liste des travaux couverts par votre contrat. Soyez aussi précis que possible. Par exemple, au lieu de lister les points de terminaison à documenter et les informations à inclure (comme un exemple de commande curl ou une liste de paramètres), au lieu de consulter la section "Documentation de l'API",
- Comment savoir si un contenu est "terminé" ?
- Autres points à prendre en compte :
- Qui détiendra les droits d'auteur sur l'œuvre ? Avec quelle licence sera-t-il disponible ? Ce sont des licences différentes ? De quel crédit le rédacteur technique recevra-t-il (mention dans le site, contributeur, etc.) ? Que se passe-t-il si le contenu doit faire l'objet d'une nouvelle licence ? Par exemple, si vous prévoyez que le rédacteur technique signe le contrat de licence des contributeurs pour votre projet Open Source, vous devez l'en informer.
- Si vous prévoyez que le rédacteur technique participera à plusieurs réussites de révision, énumérez-les. Par exemple, vous pouvez indiquer que vous prévoyez une première ébauche, une deuxième étape pour résoudre des problèmes techniques, puis une dernière étape de relecture.
- Si vous prévoyez que le rédacteur technique fournira du contenu dans un format spécifique, tel que Markdown, incluez-le dans votre contrat.
- Votre projet comporte-t-il des consignes d'utilisation de l'IA générative pour créer de la documentation ou du code ? Veillez à communiquer ces consignes à votre rédacteur technique.
Rémunération
- Convenir avec le rédacteur technique d'un échéancier des paiements lié aux dates fermes et aux produits livrables
- Allez-vous payer un montant initial au début des travaux ?
- Que se passe-t-il si le travail ne peut pas être utilisé ou accepté (parce que les priorités du projet ont changé, ou parce qu'un évaluateur a abandonné le projet, etc.) ? Pouvez-vous payer des frais pour compenser le temps passé par le rédacteur technique ?
- Qui sera responsable des frais de conversion de devises liés au mode de paiement choisi ?
Communication
- Vous attendez-vous à ce que le rédacteur technique soit disponible pour les appels vidéo ou les visioconférences ?
- Quels canaux de communication allez-vous utiliser et quels sont les temps de réponse attendus ? Par exemple, si vous prévoyez qu'un rédacteur technique répond aux e-mails (ou aux messages dans Slack) dans un délai d'une journée, indiquez-le explicitement.
- Qui, parmi les membres du projet, peut-il contacter pour différentes questions, par exemple des problèmes de paiement, des demandes d'examen, le déblocage des problèmes liés aux outils ou aux canaux, ou d'autres obstacles ?
- Y a-t-il un processus spécifique que le rédacteur devrait utiliser pour soumettre son travail ou obtenir des commentaires ou des avis ?
Outils
- Quels outils (ou versions d'outils) le rédacteur technique doit-il utiliser pour créer son travail ?
- Qui est chargé d'aider le rédacteur technique à configurer, à obtenir l'accès ou à obtenir des autorisations ?
Résoudre les désaccords
- Comment résoudrez-vous les désaccords sur la qualité du travail du rédacteur technique ? Qui a le dernier mot ?
- Quel serait le processus de libération du rédacteur technique du projet ? Par exemple, l'absence de trois délais d'affilée ou la remise d'un travail de qualité inacceptable. Lors de la mise en œuvre du processus, pensez à indiquer explicitement les prochaines étapes ("Le premier brouillon devrait être envoyé d'ici vendredi prochain" plutôt que "Veuillez envoyer votre travail dès que possible").
- Si un rédacteur technique doit abandonner le processus, comment doit-il le faire savoir ? Si possible, doit-il le notifier, créer un document de transfert ou organiser une réunion de transfert ?
- N'oubliez pas de tenir compte des obligations du projet vis-à-vis du rédacteur technique. Par exemple, si les mentors de votre projet abandonnent et ne peuvent pas être remplacés, ou si les examens promis ne peuvent pas être effectués, envisagez de verser une partie des fonds restants au rédacteur technique, même si le projet ne peut pas être terminé, pour le rémunérer pour son temps.
- Indiquer explicitement que le rédacteur technique est lié par le code de conduite du projet et ajouter un lien vers le processus d'application de votre code de conduite. Vous pouvez indiquer explicitement que le non-respect du règlement de la communauté entraînera la cessation du projet et la perte de paiement pour tout travail en cours.