Phase actuelle:
Études de cas publiées. Voir la chronologie.
Cette page contient quelques questions à prendre en compte lorsque vous créez un contrat avec un rédacteur technique pour la Google Season of Docs. Il ne s'agit pas d'un conseil juridique ni d'une liste exhaustive de tous les points à prendre en compte lors de la création de contrats d'écriture technique pour des projets Open Source. Selon les 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 "Documentation de l'API", dressez la liste des points de terminaison à documenter et des informations à inclure, telles qu'un exemple de commande curl ou une liste de paramètres.
- Comment savoir si un contenu est "terminé" ?
- Autres points à prendre en compte :
- Qui sera le titulaire des droits d'auteur de l'œuvre ? Sous quelle licence sera-t-il publié (ces licences sont différentes) ? Quel crédit le rédacteur technique recevra-t-il (mention sur le site, crédité en tant que contributeur, etc.) ? Que se passe-t-il si le contenu doit être réautorisé à l'avenir ? Par exemple, si vous attendez du rédacteur technique qu'il signe le contrat de licence des contributeurs de votre projet Open Source, vous devez le lui indiquer.
- Si vous attendez du rédacteur technique qu'il participe à plusieurs révisions, précisez-le. Par exemple, vous pouvez indiquer que vous attendez une première ébauche, puis une deuxième pour résoudre les problèmes techniques, puis une dernière pour la relecture.
- Si vous attendez du rédacteur technique qu'il fournisse du contenu dans un format spécifique, comme Markdown, incluez-le dans votre contrat.
- Votre projet comporte-t-il des consignes sur l'utilisation de l'IA générative pour créer de la documentation ou du code ? Assurez-vous que ces consignes sont partagées avec votre rédacteur technique.
Rémunération
- Définissez avec le rédacteur technique un calendrier de paiement lié à des dates et des livrables fermes.
- Allez-vous verser un acompte 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 qu'un réviseur a abandonné, etc.) ? Pouvez-vous payer des frais de résiliation pour compenser le temps passé par le rédacteur technique ?
- Qui sera responsable des frais de conversion de devise liés au mode de paiement choisi ?
Communication
- Attendez-vous que le rédacteur technique soit disponible pour des appels vidéo ou des réunions ?
- Quels canaux de communication allez-vous utiliser et quels sont les délais de réponse attendus ? Par exemple, si vous attendez d'un rédacteur technique qu'il réponde aux e-mails (ou aux messages sur Slack) dans un délai d'une journée, indiquez-le clairement.
- Qui peut-il contacter dans le cadre du projet pour différentes questions, comme des problèmes de paiement, un besoin d'examen, des problèmes de déblocage des outils ou des canaux, ou d'autres obstacles ?
- Existe-t-il un processus spécifique que l'auteur doit suivre pour envoyer 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 à se configurer, à obtenir un accès ou à obtenir des autorisations ?
Résoudre les désaccords
- Comment allez-vous résoudre les désaccords sur la qualité du travail du rédacteur technique ? Qui a le dernier mot ?
- Comment procéder pour libérer le rédacteur technique du projet ? Par exemple, ne pas respecter trois échéances de suite ou rendre un travail de qualité inacceptable. Lorsque vous appliquez le processus, envisagez de donner des étapes suivantes explicites ("Nous attendons une demande de tirage pour le premier brouillon d'ici vendredi prochain" plutôt que "Veuillez envoyer votre travail dès que possible").
- Si un rédacteur technique doit abandonner, comment doit-il le communiquer ? Si possible, doit-il envoyer un avis, créer un document de transfert ou passer un appel de transfert ?
- N'oubliez pas de prendre en compte les obligations du projet envers le rédacteur technique. Par exemple, si les mentors de votre projet abandonnent et ne peuvent pas être remplacés, ou si les évaluations promises ne peuvent pas être effectuées, envisagez de verser une partie des fonds restants au rédacteur technique, même si le projet ne peut pas être mené à bien, afin de le rémunérer pour son temps.
- Indiquez explicitement que le rédacteur technique est tenu par le code de conduite du projet et fournissez un lien vers votre procédure d'application du code de conduite. Vous pouvez indiquer explicitement que les cas de non-respect du règlement entraîneront l'arrêt du projet et la perte du paiement pour tout travail en attente.