search

rlalfo / google-http-java-client

Automatically exported from code.google.com/p/google-http-java-client
0 stars 0 forks source link

Mark some parts of the library Preview #208

Closed GoogleCodeExporter closed 9 years ago

GoogleCodeExporter commented 9 years ago 
External references, such as a standards document, or specification?

https://code.google.com/p/google-http-java-client/issues/detail?id=177

Java environments (e.g. Java 6, Android 2.3, App Engine, or All)?

All

Please describe the feature requested.

In issue 177 we added an @Experimental annotation that indicates that parts of 
the library make break in the future.  We need to also add an @Preview 
annotation that indicates a higher level of quality and that we are committed 
to supporting those features for a long time.  We still reserve the right to 
making breaking changes, but we will try to minimize those.  A good example of 
such a "Preview" feature: all of the Android support.

We will change our FindBugs plugin to also catch uses of the @Preview 
annotation by default.  However, we will provide a way to disable checks for 
uses of the @Preview annotation.  Alternatively, we can just provide two 
different plugins, one for Experimental and one for Preview.

Original issue reported on code.google.com by yan...@google.com on 15 Mar 2013 at 10:52

GoogleCodeExporter commented 9 years ago 
Closing for now until we get agreement internally on the proper policy.

Original comment by yan...@google.com on 16 Mar 2013 at 1:12

GoogleCodeExporter commented 9 years ago

Original comment by yan...@google.com on 28 Mar 2013 at 2:34