Re: [PHP-DEV] Moving `php-src/docs` forward

Hey Ilija,

On 21.08.26 20:04, Ilija Tovilo wrote:
>> That's only because you picked a commit from a non-final state that 
>> solely exists to keep diffs small; mind the still existing `.rst` 
>> extension. I would really appreciate if you could please at least 
>> once look at the final PR instead of bit by bit arguing about 
>> non-final state.
>
> To be fair, you created 8 PRs and pinged me only in the first one. So 
> naturally that's what I look at and judge. But as I already said in my 
> response, switching the file name to .md will fix some formatting 
> issues while creating others. You'll need a custom MyST plugin to fix 
> it. That's fine, but I'd like to remind you that your original 
> argument was that reST is somehow not well supported by GitHub or 
> IDEs, which is just incorrect.


The first PR explains everything for the full series in its description. 
What for do we need a custom MyST plugin? What is to fix? And what 
formatting issues? I cannot address if I don't know what this is about. 
Could you please be more specific?

My original argument are the 5 points in the PR description of the first 
PR, not the single one you are mentioning now. And they were all 
correct; that now tables are not rendered is because you asked for the 
non-Markdown ones. Wo that's the trade off.

> I won't respond to the rest of your e-mail, as it reads like a rant 
> and personal attack.


Nothing of what I wrote was a rant, nor meant personal? I calmly and 
rationally answered your email. I was simply pointing out that you 
apparently not looked at the whole thing, which you now confirmed. My 
point is that it is not productive to talk about in between steps 
because it leads to wrong assumptions. For me as a non-native speaker my 
mail reads polite. So not at all sure what you mean, but sorry anyway if 
it came over different than I meant it.

I'd appreciate if you could re-consider to answer, because I think it 
had important bits; and as clarified above nothing of this was meant as 
a rant or personal.

> Ilija 

---

Cheers
Nick