Re: documentation is now XML

Andrew Dunstan <andrew(dot)dunstan(at)2ndquadrant(dot)com> writes:
> On 11/28/2017 12:06 PM, Tom Lane wrote:
>> One thing we'd definitely better do is enable some buildfarm coverage.
>> AFAIK, the only buildfarm animal that's building the docs is guaibasaurus,
>> and it only seems to be doing that on HEAD. Since this has considerably
>> increased the risks of back-patching creating busted docs in the back
>> branches, we'd better spin up some back-branch testing as well.

> crake builds the docs on all branches pretty regularly. I have changed
> its config so it builds them pretty much every build.

Oh, excellent, thanks.

> Of course, it's only building the HTML docs. Do we need more than that?
> Continuously making PDFs seems a bit excessive.

I think sanity-checking the SGML/XML is the only part we need to do
regularly, so building HTML seems like plenty. The only point of
doing test PDF builds is to check for the link-crosses-a-page issue,
and I do not think it's worth worrying about that except very near
to a release. A problem we fix today might be gone tomorrow anyway.

regards, tom lane