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

[Andrea Cervesato]

Hi Wojtek,

thanks for your suggestions. I will take a look at it.

Kind regards,
Andrea Cervesato

On 3/22/24 11:47, Wojtek Porczyk wrote:
> 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.
>
>