Projekt SymPy

Ta strona zawiera szczegółowe informacje o projekcie polegającym na pisaniu tekstów technicznych, który został zaakceptowany w ramach Google Season of Docs.

Podsumowanie projektu

Organizacja open source:
SymPy
Pisarz techniczny:
Rohit Goswami
Nazwa projektu:
SymEngine
Długość projektu:
Standardowa długość (3 miesiące)

Opis projektu

Chociaż dokumentacja Sympy jest dość łatwo dostępna, dokumentacja SymEngine jest obecnie w większości niedostępna. W kodzie źródłowym są komentarze, ale trzeba je ponownie sformatować, aby można było ich używać w Doxygen. Proponowany projekt jest kompleksowy i obejmie skonfigurowanie potoku CI do generowania witryny z dokumentacją, a także ulepszenia istniejących dokumentów (w zakresie pokrycia i przykładów ogólnych). Obejmuje to również przeniesienie odpowiednich fragmentów z wiki i innych źródeł oraz dodanie przewodnika dla współtwórców. W projekcie wspomina się o możliwości użycia Sphinxa, ale osobiście jestem temu przeciwny, ponieważ Doxygen bardzo dobrze radzi sobie bez dalszej obróbki (np. https://docs.dseams.info). Jeśli to konieczne, mogę jednak skonfigurować więcej interfejsów. Chcę też wygenerować wersję PDF tej dokumentacji. Cele dodatkowe będą obejmować ustawienie wielu przykładów dotyczących Symengine i zezwalanie na akceptację wkładów użytkowników. Chcę też skonfigurować społeczność Zenodo dla Sympy i SymEngine.