Проект SymPy

На этой странице содержится подробная информация о проекте технического написания, принятом для участия в Google Season of Docs.

Краткое описание проекта

Организация с открытым исходным кодом:
СимПи
Технический писатель:
Рохит Госвами
Название проекта:
SymEngine
Длина проекта:
Стандартная продолжительность (3 месяца)

Описание проекта

Хотя документация Sympy достаточно доступна, документация SymEngine в настоящее время по большей части недоступна. В исходном коде есть комментарии, но их необходимо переформатировать для лучшего использования с Doxygen. Проектное предложение является комплексным и будет охватывать создание конвейера CI для создания веб-сайта с документацией, а также улучшения существующих документов (с точки зрения охвата и примеров высокого уровня). Это также включает в себя использование соответствующих фрагментов из вики и других источников, а также добавление руководства для участников. В проекте упоминается возможность использования Sphinx, но лично я против этого, поскольку Doxygen прекрасно справляется без дальнейшей обработки (например, https://docs.dseams.info). Однако при необходимости я готов настроить больше внешних интерфейсов для потребления. Я также хотел бы создать PDF-версию документации. Расширенные цели будут включать в себя создание нескольких конкретных примеров Symengine и разрешение принятия вкладов пользователей. Я также хотел бы создать сообщество Zenodo для Sympy и SymEngine.