[Buildroot] [PATCH 00/16 v3] br2-external: support multiple trees at once (branch yem/multi-br2-external-ID-7)

[Arnout Vandecappelle]

On 01-09-16 23:46, Yann E. MORIN wrote:
> Arnout, All,
> 
> On 2016-09-01 23:43 +0200, Arnout Vandecappelle spake thusly:
[snip]
>>  One remark though: we should really document such backward compatibility
>> issues. I don't think we're currently doing that well.
>>
>>  Where should this be done?
>>
>> - In CHANGES? At the moment, however, the CHANGES file is not really inviting to
>> look for that kind of thing. Especially because users will often upgrade in
>> jumps of 4 or more releases - that makes up 900 lines of CHANGES text...
>>
>> - In the manual? There isn't really an appropriate place for it at the moment.
>> And how long do we keep it there?
>>
>> - In some new location? Where?
>>
>>  My personal preference would be in the manual, and keep it for a couple of years.
> 
> And since we can detect this situation, we can point the user to the
> manual and/or emit the brief suggestion you previously posted.

 Right, that's true. In that case, having it documented in the manual or
somewhere else isn't really needed - documenting it where it hits you right in
the face is sufficient :-)

 Regards,
 Arnout


-- 
Arnout Vandecappelle                          arnout at mind be
Senior Embedded Software Architect            +32-16-286500
Essensium/Mind                                http://www.mind.be
G.Geenslaan 9, 3001 Leuven, Belgium           BE 872 984 063 RPR Leuven
LinkedIn profile: http://www.linkedin.com/in/arnoutvandecappelle
GPG fingerprint:  7493 020B C7E3 8618 8DEC 222C 82EB F404 F9AC 0DDF