Evolving an API without losing compatibility

http://www.eclipse.org/eclipse/development/java-api-evolution.html

An article from the Eclipse team on maintaining backwards compatibility with library methods and classes.  Helps make clear what is and isn't a "public API", addressing both compile-time and binary issues.