Re: [LTP] [PATCH 00/10] New LTP documentation

[Wojtek Porczyk <woju@invisiblethingslab.com>]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512

[ sorry for repost, the list does not seem to like PGP/MIME ]

On Thu, Mar 21, 2024 at 09:56:56AM +0100, Petr Vorel wrote:
> > On 3/21/24 09:25, Petr Vorel wrote:
> > > > 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
> > readthedocs works with any kind of git server. The only thing we need, it's
> > a .readthedocs.yaml file inside a specific branch (i.e. master).
> > So we need to create an account for the LTP team in readthedocs.com, then we
> > provide the git repo to readthedocs and site will be published
> > automatically.
> > ltp.readthedocs.io is available, so maybe we should create an account
> > already.
>
> ack.
>
> > > I guess you now deploy to your fork manually, otherwise you would add GitHub
> > > Action config in the patchset.
> > It's automatic done by readthedocs and we don't need Github actions.

If you're on GitHub on GitLab, may I recommend pull request previews:
https://docs.readthedocs.io/en/stable/pull-requests.html
https://docs.readthedocs.io/en/stable/guides/pull-requests.html

RTD will build partial (HTML-only) docs for each push to a PR. It's very nice
for online review, you won't need to push to your own ltp-something.rtfd.io
variant.


- -- 
pozdrawiam / best regards
Wojtek Porczyk
Gramine / Invisible Things Lab
 
 I do not fear computers,
 I fear lack of them.
    -- Isaac Asimov
-----BEGIN PGP SIGNATURE-----

iQIzBAEBCgAdFiEEaO0VFfpr0tEF6hYkv2vZMhA6I1EFAmX9Yi4ACgkQv2vZMhA6
I1FLLhAAhmWu1bFmcQB8uKNb+3d9OuPA7lwsnuK7Lo7HXQNaWG4qGdQBQLIwi4by
SEBEIw0olU7BF2JVvRun+KGHB9j5PCSHJmXFdmbQy2WLetVdc6Aogwr9O/w2gIvf
/5+iQNBdxe5dfB6naK5MnrR05S83bqjrsRtsDE+Bvng9yWuVdD4xvQTnZNOmfsOK
nzpZs0gNJszzuZ6hHu8dKulvBmqVlRS/+K5Agnd1W1Vc1ZOrJcPuFcn3GipvROgq
s8boPhBaGRoXWfU2Ye/ROw/WcgO/H2ISOC9N9RpQ9y5oQnDmMd6NnrlMEVEjUFkL
5xgqJUsOoisiodemoAFr5fPqvwpnCQQzy7OV3B2VMkrV/arXj9TQKkvKz7LA2HA5
YI5MGajflEZNoL4t5BjmBDMhF3UdlXxYW/EK946qkIpWm8ylX52CEHNXb7FSpNqY
IKDvORWb3TH+mGyLJO2Zyywd3IPnd8Z5v17+qyLMZWg5zfwUJbTPu2c5IXYCA8vf
umoDLdIow0ccnBQE1JE8UTMKvLFuC0w4XJgrvc0b7d+uzV1tbaSoL87XQib3EWYA
tM2Y3o0LTebiaF2UH17D71nvBQbpTEdoKgQa9TUpqdLyzLRuByUcK0odbWC9WDkG
iMwUHyaf0+GGSbrpGK5oNJDsA89Q2ElcqeLBhVY/0W4z1jxHM20=
=acLP
-----END PGP SIGNATURE-----

-- 
Mailing list info: https://lists.linux.it/listinfo/ltp