Re: [Ksummit-2013-discuss] [RFC] of: Allow for experimental device tree bindings

[Thierry Reding <thierry.reding-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>]

[-- Attachment #1: Type: text/plain, Size: 1112 bytes --]

On Wed, Oct 23, 2013 at 08:40:00PM +0100, Wolfram Sang wrote:
> 
> > > I'd even go further and use "unstable-" as the prefix instead of "!"
> > > which is way more explicit.
> > 
> > I guess unstable- is as good as anything. I personally think that "!" is
> > disturbing enough to the eye to make it abundantly clear that something
> > is fishy.
> 
> "!" marks the binding as "special" whatever that is. A busy person might
> decide to not look that up as long as it works right now. "unstable-"
> (or maybe "unstable!-" ;)) is explicit so people know what they get.

We'll need to document this somewhere to make people aware of it. And if
nobody bothers to read that documentation then they're not entitled to
complain.

That said, in my experience people are just as likely to ignore anything
with an "unstable" in it until it breaks. Also I don't think "unstable"
is the right term. "unstable" implies that it somehow influences the
system stability. But that's not the case. "experimental" is much more
accurate in that developers are experimenting with the representation.

Thierry

[-- Attachment #2: Type: application/pgp-signature, Size: 836 bytes --]