Added a useful reference to the README (#356)

* Added a useful reference to the README template
* Line breaks
* Generated the updated README

Author: neboskreb

README.md

@@ -239,6 +239,36 @@ At this time, Google hasn't shared any immediate plans to bring first-party supp
 - [Add support for JUnit 5 (issuetracker.google.com)](https://issuetracker.google.com/issues/127100532)
 - [JUnit 5 support (github.com/android/android-test)](https://github.com/android/android-test/issues/224)
 
+## Support for @Rules
+
+Since JUnit 5 has replaced the `@Rule` mechanism with Extensions, the following artifacts help bridge the gap until Android officially transitions to JUnit 5.
+
+### InstantExecutorExtension
+
+Replaces `InstantTaskExecutorRule` in JUnit 5.
+
+<details>
+  <summary>Kotlin</summary>
+
+  ```kotlin
+  dependencies {
+      testImplementation("io.github.neboskreb:instant-task-executor-extension:1.0.0")
+  }
+  ```
+</details>
+
+<details>
+  <summary>Groovy</summary>
+
+  ```groovy
+  dependencies {
+      testImplementation 'io.github.neboskreb:instant-task-executor-extension:1.0.0'
+  }
+  ```
+</details>
+
+For more details see [instant-task-executor-extension](https://github.com/neboskreb/instant-task-executor-extension) on GitHub.
+
 ## Building Locally
 
 This repository contains multiple modules, divided into two sub-projects. The repository's root directory contains build logic shared across the sub-projects, which in turn use symlinks to connect to the common build scripts in their parent folder.

README.md.template

@@ -234,6 +234,36 @@ At this time, Google hasn't shared any immediate plans to bring first-party supp
 - [Add support for JUnit 5 (issuetracker.google.com)](https://issuetracker.google.com/issues/127100532)
 - [JUnit 5 support (github.com/android/android-test)](https://github.com/android/android-test/issues/224)
 
+## Support for @Rules
+
+Since JUnit 5 has replaced the `@Rule` mechanism with Extensions, the following artifacts help bridge the gap until Android officially transitions to JUnit 5.
+
+### InstantExecutorExtension
+
+Replaces `InstantTaskExecutorRule` in JUnit 5.
+
+<details>
+  <summary>Kotlin</summary>
+
+  ```kotlin
+  dependencies {
+      testImplementation("${libs.instantTaskExecutorExtension}")
+  }
+  ```
+</details>
+
+<details>
+  <summary>Groovy</summary>
+
+  ```groovy
+  dependencies {
+      testImplementation '${libs.instantTaskExecutorExtension}'
+  }
+  ```
+</details>
+
+For more details see [instant-task-executor-extension](https://github.com/neboskreb/instant-task-executor-extension) on GitHub.
+
 ## Building Locally
 
 This repository contains multiple modules, divided into two sub-projects. The repository's root directory contains build logic shared across the sub-projects, which in turn use symlinks to connect to the common build scripts in their parent folder.

build-logic/src/main/kotlin/Dependencies.kt

@@ -84,4 +84,8 @@ object libs {
     const val composeUiTest = "androidx.compose.ui:ui-test"
     const val composeUiTestJUnit4 = "androidx.compose.ui:ui-test-junit4"
     const val composeUiTestManifest = "androidx.compose.ui:ui-test-manifest"
+
+    // Documentation
+    // For the latest version refer to GitHub repo neboskreb/instant-task-executor-extension
+    const val instantTaskExecutorExtension = "io.github.neboskreb:instant-task-executor-extension:1.0.0"
 }