Docs: add AspectJ Java version compatibility table

Signed-off-by: Alexander Kriegisch <Alexander@Kriegisch.name>

1 files changed, 23 insertions, 0 deletions

diff --git a/docs/dist/doc/JavaVersionCompatibility.md b/docs/dist/doc/JavaVersionCompatibility.md
new file mode 100644
index 000000000..be557d462
--- /dev/null
+++ b/docs/dist/doc/JavaVersionCompatibility.md
@@ -0,0 +1,23 @@
+# AspectJ Java version compatibility
+
+For reasons described e.g. in [this comment](https://github.com/eclipse/org.aspectj/issues/139#issuecomment-1072946123),
+for AspectJ users it has become a little challenging to find out which minimum AspectJ version is required in order to
+process byte code or compile source code using features of a certain Java language version. Since Java 10, this cannot
+be easily concluded from the AspectJ version number anymore, and we are sorry for that. So here is a little overview:
+
+AspectJ version | Java version | Comments
+----------------|--------------|--------
+1.9.8 | 17 | AspectJ compiler requires JDK 11+ during build time. During runtime, AspectJ still only requires Java 8+ for both compile-time and load-time weaving. Pure Java code can be compiled down to as old as 1.3 byte code level.
+1.9.7 | 15, 16
+1.9.6 | 14
+1.9.5 | 13
+1.9.3 - 1.9.4 | 12
+1.9.2 | 11
+1.9.1 | 10
+1.9.0 | 9
+1.8.0 - 1.8.14 | 8
+1.7.0 - 1.7.4 | 7
+1.6.0 - 1.6.12 | 6
+1.5.0 - 1.5.4 | 5
+
+Older versions omitted.