[LTP] [PATCH 00/10] New LTP documentation
Petr Vorel
pvorel@suse.cz
Thu Mar 21 09:25:59 CET 2024
Hi Andrea,
> The new LTP documentation is meant to use Sphinx as the main
> documentation framework, with ReconStructedText as the main language.
> All the conversion has been done step-by-step, each chapter at time,
> updating english syntax and fixing typos. There are minor improvements,
> but overall the structure is the same.
> C / Networking / KVM API are not documented yet, because they will be
> probably integrated in the LTP library. C API documentation is already
> on going, but the others not.
> For a demo, please take a look at:
> https://ltp-acerv.readthedocs.io/en/latest/index.html
Out of curiosity, we need to register LTP on readthedocs.io.
Then we need GitHub Action hook (including some secret for auth) for publishing.
Correct?
https://docs.readthedocs.io/en/stable/guides/setup/git-repo-manual.html
I guess you now deploy to your fork manually, otherwise you would add GitHub
Action config in the patchset.
Also, what I like (for the future) offline formats (PDF, ePub, HTML) are
supported:
https://docs.readthedocs.io/en/stable/downloadable-documentation.html
Also, I would prefer when this merged it would actually replace the old github
docs (otherwise we maintainers endup maintaining both - getting fixes for both).
E.g. in the final version first deleting the old docs + github update hook.
Kind regards,
Petr
More information about the ltp
mailing list