Re: Docbook 5.x - Mailing list pgsql-docs

From Alexander Law
Subject Re: Docbook 5.x
Date
Msg-id 572AD224.5070307@gmail.com
Whole thread Raw
In response to Re: Docbook 5.x  (Peter Eisentraut <peter.eisentraut@2ndquadrant.com>)
List pgsql-docs
Hello Peter,
I fully support your plan  and going to move this way.

Best regards,
Alexander

05.05.2016 04:09, Peter Eisentraut пишет:
> On 5/4/16 11:08 AM, Alexander Law wrote:
>> As was stated in the aforementioned thread, solution 2 can be much (8x)
>> faster with some xslt optimizations, but I think now we should outline
>> some roadmap before we start to prepare patches and so.
>> Maybe we should convert to XML with DocBook4 at first step?
>> Then, once we get everything stabilized, we can upgrade to DocBook5.
>> Shouldn't we decompose the conversion procedure, so we could perform
>> fully automatic conversion without any manual changes, and then fix
>> non-valid situations, you described before?
>
> I think the process should be something like this:
>
> - Apply your XSLT performance patch.  The patch should be submitted to
> the next commit fest.
>
> - Wait a while to make sure everyone is happy with the performance.
> Keep tweaking if necessary.
>
> - Port all DSSSL customizations to XSLT.  Manually evaluate output for
> quality.
>
> - Switch to XSLT build for official HTML documentation. [milestone 1]
>
> - Convert sources to XML. (There could be substeps here.) [milestone 2]
>
> - Then consider upgrading to DocBook 5. [milestone 3]
>



pgsql-docs by date:

Previous
From: Alexander Law
Date:
Subject: Re: Docbook 5.x
Next
From: "David G. Johnston"
Date:
Subject: max_worker_processes default not documented