[Lazarus] Attn. Don, documentation snapshots via CI

[Michael Van Canneyt]

On Thu, 15 Dec 2022, Maxim Ganetsky via lazarus wrote:

> Hello.
>
> As a first step of solving outdated documentation snapshot issue 
> (https://gitlab.com/freepascal.org/lazarus/lazarus/-/issues/40032 ) I propose 
> to generate it as an artifact of CI job (in `main` branch for now), which 
> then can be uploaded wherever we want.
>
> So I have the following questions:
>
> 1. FPDoc from which FPC version is preferred (from `main` branch I guess)?

main.

> 2. Where rtl.xct and fcl.xct should be obtained? Should FPC documentation be 
> built first?

rtl.xct and fcl.xct are generated when the FPC documentation is built.

However, note that the documentation of FPC is only updated after a release.
so if you use FPC main to generate documentation, it will not match what FPC
publishes.

> 3. Should we build HTML, CHM or both?

If it is for upload, then CHM makes no sense to me, but that's up to the
lazarus team, obviously...

Michael.