Re: DOCS: add helpful partitioning links

On Thu, Mar 28, 2024 at 11:43 PM Ashutosh Bapat
<ashutosh.bapat.oss@gmail.com> wrote:
> On Thu, Mar 28, 2024 at 11:22 PM Alvaro Herrera <alvherre@alvh.no-ip.org> wrote:
>>
>> On 2024-Mar-28, Ashutosh Bapat wrote:
>>
>> > LGTM.
>> >
>> > The commitfest entry is marked as RFC already.
>> >
>> > Thanks for taking care of the comments.
>>
>> Thanks for reviewing.  I noticed a typo "seperate", fixed here.
>
>
> Thanks for catching it.
>
>>
>> Also, I
>> noticed that Robert added an empty line which looks in the source like
>> he's breaking the paragraph -- but because he didn't add a closing </para>
>> and an opening <para> to the next one, there's no actual new paragraph
>> in the HTML output.
>>
>>
>> My first instinct was to add those.  However, upon reading the text, I
>> noticed that the previous paragraph ends without offering an example,
>> and then we attach the example to the paragraph that takes about CREATE
>> TABLE LIKE showing both techniques, which seemed a bit odd.  So instead
>> I joined both paragraphs back together.  I'm unsure which one looks
>> better.  Which one do you vote for?
>
>
> "CREATE TABLE ... LIKE" is mentioned in a separate paragraph in HEAD as well. The confused me too but I didn't find any reason. Robert just made that explicit by adding a blank line. I thought that was ok. But it makes sense to not have a separate paragraph in the source code too. Thanks for fixing it. I think the intention of the current code as well as the patch is to have a single paragraph in HTML output, same as "no-extra-para" output.
>

It does seem like the source and the html output ought to match, so +1 from me.


Robert Treat
https://xzilla.net