[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-core-devel
Subject:    Re: Keeping binary compatibility
From:       Aurélien Gâteau <aurelien.gateau () canonical ! com>
Date:       2010-10-05 13:31:15
Message-ID: 4CAB28A3.2020207 () canonical ! com
[Download RAW message or body]

On 05/10/2010 14:55, Lubos Lunak wrote:

>> README files tend to bitrot IME. apidox is a good place. techbase is
>> another good place. a "whitelist" page showing all libraries that have BC
>> commitments (with the implication that if we ship them, but they aren't on
>> that list, don't expect BC) would make sense to me. it's probably the
>> easiest place to find these things for 3rd parties.
> 
>  I don't see why a techbase page should rot less than a README file that's 
> included with the library, nor why it should be easier to find (especially if 
> the README gets shipped together with the package). But I don't care that 
> much as long as it's said somewhere reasonable.

I'd like to add that README files have the advantage of getting branched
with the rest of the code, which can be handy to check changes between
releases.

Aurélien
[prev in list] [next in list] [prev in thread] [next in thread]