Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:128599
Feedback-ID: idf69468d:Fastmail
Content-Type: multipart/alternative;
 boundary="------------zL3oZLfbuVo7VDjBj4MqYFXa"
Message-ID: <560f1bd3-5cf5-435c-ac15-65f84af122ac@allenjb.me.uk>
Date: Mon, 1 Sep 2025 12:09:24 +0100
Precedence: list
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
Subject: Re: [PHP-DEV] Reference of discussion in RFCs
To: Nick <php@nicksdot.dev>, internals@lists.php.net
References: <30FD734F-2ED4-4D48-823A-3E4E0F265D38@nicksdot.dev>
Content-Language: en-US
In-Reply-To: <30FD734F-2ED4-4D48-823A-3E4E0F265D38@nicksdot.dev>
From: php.lists@allenjb.me.uk (AllenJB)

This is a multi-part message in MIME format.
--------------zL3oZLfbuVo7VDjBj4MqYFXa
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit

On 01/09/2025 11:28, Nick wrote:
> Hey there!
>
> When I try to look into the discussions of older RFCs to find out why 
> they ended up the way they did, it’s not easy. You hardly can find 
> them. This is because they are often not referenced in the RFC itself.
>
> Going forward, would it make sense to make it mandatory to reference 
> '[Discussion]' and '[Vote]' in the RFC text itself?
>
> *Cheers*
> Nick

FYI I can usually find most RFC discussions by searching on 
https://externals.io for the RFC title

To be clear, I would also still encourage RFC authors to add discussion 
and vote thread links to RFCs. I think it helps people who are not 
familiar with the RFC process when RFCs are linked outside of the list, 
such as on Reddit or social media. I'll often add a comment to RFC posts 
on r/php to link the discussion threads so people can follow the list 
discussion.

Also, some discussions are harder to find when there's many other list 
discussions that mention the same keywords as the RFC title.

Thought: This could potentially be automated with a script that looks 
for list emails with a RFC link in the body. If the email body contains 
a RFC link, the subject contains the RFC title and either [Discussion] 
or [Vote], then add a reference to the linked RFC wiki page.

--------------zL3oZLfbuVo7VDjBj4MqYFXa
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: 8bit

<!DOCTYPE html>
<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  </head>
  <body>
    <div class="moz-cite-prefix">On 01/09/2025 11:28, Nick wrote:<br>
    </div>
    <blockquote type="cite"
      cite="mid:30FD734F-2ED4-4D48-823A-3E4E0F265D38@nicksdot.dev">
      <meta http-equiv="content-type" content="text/html; charset=UTF-8">
      Hey there!
      <div><br>
      </div>
      <div>
        <div>When I try to look into the discussions of older RFCs to
          find out why they ended up the way they did, it’s not easy.
          You hardly can find them. This is because they are often not
          referenced in the RFC itself.</div>
        <div><br>
        </div>
        <div>Going forward, would it make sense to make it mandatory to
          reference '[Discussion]' and '[Vote]' in the RFC text itself?</div>
      </div>
      <div><br>
      </div>
      <div><b>Cheers</b></div>
      <div>Nick</div>
    </blockquote>
    <p>FYI I can usually find most RFC discussions by searching on
      <a class="moz-txt-link-freetext" href="https://externals.io">https://externals.io</a> for the RFC title</p>
    <p>To be clear, I would also still encourage RFC authors to add
      discussion and vote thread links to RFCs. I think it helps people
      who are not familiar with the RFC process when RFCs are linked
      outside of the list, such as on Reddit or social media. I'll often
      add a comment to RFC posts on r/php to link the discussion threads
      so people can follow the list discussion.</p>
    <p>Also, some discussions are harder to find when there's many other
      list discussions that mention the same keywords as the RFC title.</p>
    <p>Thought: This could potentially be automated with a script that
      looks for list emails with a RFC link in the body. If the email
      body contains a RFC link, the subject contains the RFC title and
      either [Discussion] or [Vote], then add a reference to the linked
      RFC wiki page.</p>
  </body>
</html>

--------------zL3oZLfbuVo7VDjBj4MqYFXa--