Projet SymPy
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page contient les détails d'un projet de rédaction technique accepté pour la saison des documents Google.
Résumé du projet
- Organisation Open Source:
- SymPy
- Rédacteur technique:
- lglattly
- Nom du projet:
- Cohérence entre les docstrings
- Durée du projet:
- Durée standard (3 mois)
Project description
Pour ce projet, je voudrais apporter plus de cohérence aux docstrings de SymPy.
En collaboration avec mes mentors, j'ai d'abord identifié le formatage souhaité pour une docstring dans le codebase. Je créerais ensuite un guide de mise en forme de la documentation que tous les docstrings du codebase devront suivre. Mon travail sur le projet consistera également à implémenter le nouveau guide pour mettre à jour les docstrings existantes, tout en collectant et en corrigeant d'autres incohérences telles que l'utilisation de la langue ou les termes. Mes mentors et moi-même prenions ensemble des décisions éditoriales sur la façon de gérer ces incohérences supplémentaires, et les préférences stylistiques qui en résultaient étaient également ajoutées au guide.
L'objectif final du projet est de créer un guide de style et de mise en forme de la documentation qui pourra être utilisé à la fois par les développeurs et les contributeurs pour maintenir la cohérence dans les docstrings de SymPy, maintenant et à l'avenir.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/25 (UTC)."],[],["The project aims to standardize SymPy's docstrings. The technical writer will collaborate with mentors to define a consistent docstring format and create a documentation guide. This guide will be used to update existing docstrings and address inconsistencies in language and terminology. Mentors and the writer will make editorial decisions about the language, and document them. The outcome is a comprehensive guide for maintaining consistency in SymPy's docstrings.\n"]]
