Update documentation, bump version

Author: serjsysoev

CHANGELOG.md

@@ -1,6 +1,10 @@
 Changelog
 ===
 
+Version 25.0.0
+---
+* Removed Java 5 artifact.
+
 Version 24.1.0
 ---
 * `@CheckReturnValue` is not experimental anymore.

CONTRIBUTING.md

@@ -17,13 +17,6 @@ During the new version release:
 * Use 'Draft a new release' button on the Releases GitHub page; select the added tag; copy it to the release title
  field; copy the added changelog section into the release details field.
 
-### Java 5 package
-We generate annotations-java5 package for legacy clients. This package cannot use ElementType.TYPE_USE
-which appeared in Java 8. The Java 5 package is generated from common/src sources 
-stripping the `, ElementType.TYPE_USE` substring from files.
-So no Java features that appear in Java 6 or higher except `ElementType.TYPE_USE` should be used in common/src.
-New TYPE_USE annotations should be created in java8/src. They will not appear in annotations-java5 package. 
-
 ### Backward compatibility
 All the changes should be backward compatible i.e. you can only add new annotations and new elements into existing annotation. 
 If it's absolutely necessary to remove an annotation or its element we must firstly release a new major version where 

README.md

@@ -17,15 +17,15 @@ using gradle write the following in the
 `build.gradle` file (Groovy DSL)
 ```
 dependencies {
-    compileOnly 'org.jetbrains:annotations:24.1.0'
+    compileOnly 'org.jetbrains:annotations:25.0.0'
 }
 
 ```
 
 or in the `build.gradle.kts` file (Kotlin DSL)
 ```
 dependencies {
-    compileOnly("org.jetbrains:annotations:24.1.0")
+    compileOnly("org.jetbrains:annotations:25.0.0")
 }
 
 ```
@@ -34,11 +34,11 @@ To add a dependency using Maven, write the following in `pom.xml`:
 <dependency>
   <groupId>org.jetbrains</groupId>
   <artifactId>annotations</artifactId>
-  <version>24.1.0</version>
+  <version>25.0.0</version>
   <scope>provided</scope>
 </dependency>
 ```
 
-`annotations` artifact requires JDK 1.8 or higher. If your project is compiled using JDK 1.5, 1.6 or 1.7 you can use 
-the `annotations-java5` artifact instead. Please note that `annotations-java5` artifact is considered a legacy, so
- most of new annotations will appear in the `annotations` artifact only.
+`annotations` artifact requires JDK 1.8 or higher. If your project is compiled using JDK 1.5, 1.6 or 1.7 you can use
+the `annotations-java5` artifact instead. Please note that `annotations-java5` artifact is considered a legacy
+and will receive no further updates.

gradle.properties

@@ -14,5 +14,4 @@
 # limitations under the License.
 #
 
-projectVersion=24.1.0
-#JDK_5=<path-to-older-java-version>
+projectVersion=25.0.0