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 library Beta #177

Closed GoogleCodeExporter closed 9 years ago

GoogleCodeExporter commented 9 years ago
Version 1 library is on track to going out of Beta.  However, there are a few 
parts that are not ready, and therefore will continue only in the version 2 
branch.  That includes:

- Android support
- XML support
- protobuf support
- json rpc support

Anything else?

Original issue reported on code.google.com by yan...@google.com on 16 Dec 2012 at 2:35

GoogleCodeExporter commented 9 years ago

Original comment by yan...@google.com on 9 Jan 2013 at 2:45

GoogleCodeExporter commented 9 years ago

Original comment by yan...@google.com on 9 Jan 2013 at 2:45

GoogleCodeExporter commented 9 years ago

Original comment by yan...@google.com on 18 Jan 2013 at 3:09

GoogleCodeExporter commented 9 years ago
The current plan is to introduce a new @Experimental annotation that will help 
developers identify parts of the library that are still "Beta".  We will also 
change the @since tags on such API using "Experimental", e.g. "@since 
Experimental 1.15".  We will also prefix the JavaDoc with "[Experimental]" and 
add a suffix to the JavaDoc like this:

 * <p>
 * Warning: this is experimental and may be changed in incompatible ways or possibly entirely removed in a future version of the library
 * </p>

Original comment by yan...@google.com on 6 Feb 2013 at 11:57

GoogleCodeExporter commented 9 years ago
Please mark the following as Experimental:
1. Anything marked Deprecated
2. All packages with "xml", "android", "protobuf", "rpc2", "testing", or 
"webtoken" in them.
3. Anything that depends on Experimental.

Later I will go in and mark some more fine-grained things as experimental, but 
let's start with the big things.

Original comment by yan...@google.com on 4 Mar 2013 at 1:47

GoogleCodeExporter commented 9 years ago
https://codereview.appspot.com/7456050/

Original comment by pele...@google.com on 5 Mar 2013 at 2:28

GoogleCodeExporter commented 9 years ago

Original comment by pele...@google.com on 13 Mar 2013 at 3:08

GoogleCodeExporter commented 9 years ago

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