Progetto SymPy

Questa pagina contiene i dettagli di un progetto di documentazione tecnica accettato per la stagione della documentazione di Google.

Riepilogo progetto

Organizzazione open source:
SymPy
Redattore tecnico:
Rohit Goswami
Nome del progetto:
SymEngine
Durata del progetto:
Durata standard (3 mesi)

Project description

Sebbene la documentazione di Sympy sia ragionevolmente accessibile, la documentazione di SymEngine è attualmente per lo più inaccessibile. Il codice sorgente contiene commenti, ma questi devono essere riformattati per un uso migliore con Doxygen. La proposta di progetto è end-to-end e riguarderà l'impostazione di una pipeline CI per generare un sito web con la documentazione, nonché i miglioramenti alla documentazione esistente (in termini di copertura ed esempi di alto livello). Sono inclusi anche gli elementi appropriati della wiki e di altre fonti, nonché l'aggiunta di una guida per i collaboratori. Il progetto menziona la possibilità di utilizzare Sphinx, ma sono personalmente contro di questo, dato che Doxygen funziona molto bene senza ulteriore elaborazione (ad es. https://docs.dseams.info). Tuttavia, come richiesto, sono disponibile a configurare più front-end per l'utilizzo. Vorrei anche generare una versione PDF della documentazione. Gli obiettivi sfida prevedono l'impostazione di più esempi specifici di Symengine e la possibilità di accettare i contributi degli utenti. Vorrei anche configurare una community Zenodo sia per Sympy che per SymEngine.