Projet SymPy

Cette page contient les détails d'un projet de rédaction technique accepté pour la Google Season of Docs.

Résumé du projet

Organisation Open Source:
SymPy
Rédacteur technique:
Rohit Goswami
Nom du projet:
SymEngine
Durée du projet:
Durée standard (trois mois)

Project description

Bien que la documentation Sympy soit raisonnablement accessible, la documentation SymEngine est actuellement presque inaccessible. Le code source contient des commentaires, mais ils doivent être reformatés pour une utilisation optimale avec Doxygen. La proposition de projet est de bout en bout et couvre la mise en place d'un pipeline CI pour générer un site Web avec la documentation, ainsi que les améliorations apportées aux documents existants (en termes de couverture et d'exemples de haut niveau). Cela inclut également la récupération des éléments appropriés du wiki et d'autres sources, ainsi que l'ajout d'un guide pour les contributeurs. Le projet mentionne éventuellement l'utilisation de Sphinx, mais je suis personnellement contre cela, car Doxygen s'en sort très bien sans autre traitement (par exemple, https://docs.dseams.info). Cependant, si nécessaire, je suis prêt à configurer d'autres frontaux de consommation. Je souhaite également générer une version PDF de la documentation. Les objectifs ambitieux impliqueront de définir plusieurs exemples spécifiques à Symengine et d'accepter les contributions des utilisateurs. Je voudrais également créer une communauté Zenodo pour Sympy et SymEngine.