Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:125799
Feedback-ID: idf69468d:Fastmail
Content-Type: multipart/alternative;
 boundary="------------nXhbJpVoEkj4aMuq00L0onoT"
Message-ID: <2d0032fe-c7b8-4945-959e-1094d728b332@allenjb.me.uk>
Date: Mon, 14 Oct 2024 11:17:16 +0100
Precedence: bulk
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
Subject: Re: [PHP-DEV] Asymmetric visibility is a BC break
To: Bilge <bilge@scriptfusion.com>,
 Valentin Udaltsov <udaltsov.valentin@gmail.com>
Cc: internals@lists.php.net
References: <CAPyeZ4N8GMiLNVCDGxdofcy6txBhng_i2UKUGpiS5bnZ-YcYvA@mail.gmail.com>
 <2A7CF24F-3AE3-4125-965F-C65431C42DFB@gmail.com>
 <CAPyeZ4MSc=Sw9UE0soCdBEnVAJ8wXHHhYqm88OffkvNLrHPxFw@mail.gmail.com>
 <e966cf16-794d-4827-9a5e-b0de780a5b91@app.fastmail.com>
 <30a41608-a1ea-40a9-8d2a-c53c508cd89f@jnvsor.net>
 <a6cdfe39-2a18-40b1-8da5-f49e9e7a7918@app.fastmail.com>
 <CAMrTa2FM4o6q8TXdBbuHfnD66vtqFBVL2Hw6_412Bf1r2T1QMg@mail.gmail.com>
 <CAPyeZ4M0LDzPBTjT_Qa-ccB73DNatGWdARg-mKMO1T1XmnTzUg@mail.gmail.com>
 <3648840e-5c73-49c9-bc89-105ed761e5c2@scriptfusion.com>
 <CAPyeZ4Ntw7LME-CSjS8Z2OGPshpKDtfnUA78zR0YtcUFVkH31w@mail.gmail.com>
 <b1b23215-6353-42c1-8181-aff2af609166@scriptfusion.com>
Content-Language: en-US
In-Reply-To: <b1b23215-6353-42c1-8181-aff2af609166@scriptfusion.com>
From: php.lists@allenjb.me.uk (AllenJB)

This is a multi-part message in MIME format.
--------------nXhbJpVoEkj4aMuq00L0onoT
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit


On 14/10/2024 10:03, Bilge wrote:
> On 14/10/2024 02:51, Valentin Udaltsov wrote:
>> Hi, Bilge!
>>
>> I think that PHP should then clearly explain what is a BC break and
>> what isn't on a separate php.net page.
>> And even explain what php version constraints are safe for Composer libraries.
>>
>> Some languages have such a document:
>> -https://go.dev/doc/go1compat
>> -https://peps.python.org/pep-0387/
>
> Absolutely! After some 16 years using PHP, I only recently became 
> aware BC breaks are acceptable in minor versions. For anyone spending 
> significant time in open source, I think there is a tendency to become 
> semver-minded and naturally assume PHP follows the same; it does not.
>
> Cheers,
> Bilge
>
For reference, current policy on BC-breaks is here: 
https://github.com/php/policies/blob/main/release-process.rst

--------------nXhbJpVoEkj4aMuq00L0onoT
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: 7bit

<!DOCTYPE html>
<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  </head>
  <body>
    <p><br>
    </p>
    <div class="moz-cite-prefix">On 14/10/2024 10:03, Bilge wrote:<br>
    </div>
    <blockquote type="cite"
      cite="mid:b1b23215-6353-42c1-8181-aff2af609166@scriptfusion.com">
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
      <div class="moz-cite-prefix">On 14/10/2024 02:51, Valentin
        Udaltsov wrote:<span style="white-space: pre-wrap">
</span><span style="white-space: pre-wrap">
</span></div>
      <blockquote type="cite"
cite="mid:CAPyeZ4Ntw7LME-CSjS8Z2OGPshpKDtfnUA78zR0YtcUFVkH31w@mail.gmail.com">
        <pre wrap="" class="moz-quote-pre">Hi, Bilge!

I think that PHP should then clearly explain what is a BC break and
what isn't on a separate php.net page.
And even explain what php version constraints are safe for Composer libraries.

Some languages have such a document:
- <a class="moz-txt-link-freetext" href="https://go.dev/doc/go1compat"
        moz-do-not-send="true">https://go.dev/doc/go1compat</a>
- <a class="moz-txt-link-freetext"
        href="https://peps.python.org/pep-0387/" moz-do-not-send="true">https://peps.python.org/pep-0387/</a>
</pre>
      </blockquote>
      <p>Absolutely! After some 16 years using PHP, I only recently
        became aware BC breaks are acceptable in minor versions. For
        anyone spending significant time in open source, I think there
        is a tendency to become semver-minded and naturally assume PHP
        follows the same; it does not.</p>
      <p>Cheers,<br>
        Bilge<br>
      </p>
    </blockquote>
    <p>For reference, current policy on BC-breaks is here:
      <a class="moz-txt-link-freetext" href="https://github.com/php/policies/blob/main/release-process.rst">https://github.com/php/policies/blob/main/release-process.rst</a></p>
  </body>
</html>

--------------nXhbJpVoEkj4aMuq00L0onoT--