Prepare content for bump to Java 21

Author: Frank Delporte

config.toml

@@ -124,7 +124,7 @@ weight = 20
 [[menu.shortcuts]]
 name = "<i class='fab more-tag fa-github'></i> Pi4J V2 Discussions"
 identifier = "discussions"
-url = "https://github.com/Pi4J/pi4j-v2/discussions"
+url = "https://github.com/Pi4J/pi4j/discussions"
 weight = 30
 
 [[menu.shortcuts]]

content/_index.md

@@ -36,17 +36,9 @@ capabilities of embedded platforms such as the Raspberry Pi.
 
 The Pi4j project has evolved in all these years as the whole Java eco-system and Raspberry Pi systems have been evolving.
 
-This resulted in two main versions.
+This resulted in the following main versions:
 
-#### Version 1
+* [V1.X.X](/about/info-v1): Deprecated, based on Java 8, later Java 11.
+* [V2.X.X](/about/info-v2): Completely reworked code base, based on Java 11.
+* [V3.X.X](/about/license): Based on latest V2, based on Java 21.
 
-The original library which started in 2012 and got a last release in 2021. Up till **version 1.3 the library targets Java 8**, while **version 1.4 relies on Java 11**. 
-
-More info is provided on ["Previous versions (V.1)"](/about/previous-version-v1/).
-
-#### Version 2
-
-As of Version 2.0, Pi4J **no longer includes support for peripheral devices and
-add-on chipsets/boards** as part of the core project. A new plugin model has been introduced in version 2.0 that helps to enable third-party development and support third-party add-ons which can be developed and maintained independently of the core Pi4J project.
-
-More info is provided on ["What's New (V.2)"](/about/new-in-v2/).

content/about/previous-version-v1.md content/about/info-v1.md

@@ -1,8 +1,14 @@
 ---
-title: 'Previous versions (V.1)'
+title: 'Info about V.1'
 weight: 20
 ---
 
+The original library which started in 2012 and got a last release in 2021. Up till **version 1.3.0 the library targets Java 8**, while **version 1.4.0 relies on Java 11**.
+
+More info is provided on ["Previous versions (V.1)"](/about/previous-version-v1/).
+
+[The sources of V1 can be found in the read-only GitHub repository `pi4j/pi4j-v1`](https://github.com/Pi4J/pi4j-v1).
+
 ## Documentation of the 1.X versions
 
 ### Pi4J Version 1.4

content/about/new-in-v2.md content/about/info-v2.md

@@ -1,8 +1,14 @@
 ---
-title: 'What''s New (V.2)'
-weight: 30
+title: 'What''s New in V.2'
+weight: 21
 ---
 
+As of versions 2.X.X, Pi4J **no longer includes support for peripheral devices and add-on chipsets/boards** as part of the core project. A new plugin model has been introduced in version 2.0 that helps to enable third-party development and support third-party add-ons which can be developed and maintained independently of the core Pi4J project. **V2-versions of Pi4J require Java 11** or higher.
+
+More info is provided on ["What's New (V.2)"](/about/new-in-v2/).
+
+[The sources of V2 can be found in the GitHub repository `pi4j/pi4j`](https://github.com/Pi4J/pi4j).
+
 ## What's New in 2.0?
 
 Pi4J version 2.0 brings with it many new features, and an entirely new architecture that focuses on 
@@ -50,12 +56,12 @@ The following features have been removed from the Pi4J library:
 
 ## Sources
 
-The Pi4J V.2 source code is available in this GitHub repository: [Pi4J V.2 GitHub Repository](https://github.com/Pi4J/pi4j-v2)
+The Pi4J V.2 source code is available in this GitHub repository: [`pi4j/pi4j` GitHub Repository](https://github.com/Pi4J/pi4j)
 
 ```shell
-git clone https://github.com/Pi4J/pi4j-v2
+git clone https://github.com/Pi4J/pi4j
 ```
 
 Pi4J V.2 had the first release in August 2021. Rework from V.1 to V.2 took quit some time and will never be finished, but
 we are confident this is a great library to develop Java application on the Raspberry Pi. Any remarks and contributions
-are welcome as either bug reports or discussions in the [GitHub repository](https://github.com/Pi4J/pi4j-v2).
+are welcome as either bug reports or discussions in the [GitHub repository](https://github.com/Pi4J/pi4j).

content/about/info-v3.md

@@ -0,0 +1,42 @@
+---
+title: 'What''s New in V.3'
+weight: 22
+---
+
+Versions 3.0.0 is based on 2.8.0 (released in January 2025), but bumps the **Java version to 21** or newer! We [asked our users](https://github.com/Pi4J/pi4j/discussions/409) which minimal Java version we should use, but there was no one clear answer, as expected ;-)
+
+The current, latest, Long Term Support (LTS) version of Java is version 21. So it makes sense to jump forward from 11 to 21. This will also prepare us for a the next LTS, which will be 25 in September 2025. Bumping to the latest LTS makes it possible to make use of many newer Java language and runtime improvements, simplify some of the code, etc.
+
+We would like to move to Java 22 as this would allow us to easier call C code to interact with the GPIOs, thanks to [JEP 454: Foreign Function & Memory API](https://openjdk.org/jeps/454). Unfortanelty, 22 is not a LTS, so it would force us to bump the version every six months with each new release, up till 25.
+
+[The sources of V3 can be found in the GitHub repository `pi4j/pi4j`](https://github.com/Pi4J/pi4j).
+
+## What's New in 3.0?
+
+Pi4J version 3.0.0 is a continuation of 2.8.0, but bumps the minimal Java version to 21.
+
+## Sources
+
+The Pi4J V.3 source code is available in this GitHub repository: [`pi4j/pi4j` GitHub Repository](https://github.com/Pi4J/pi4j)
+
+```shell
+git clone https://github.com/Pi4J/pi4j
+```
+
+Pi4J V.3 is not yet released, but can already use version `3.0.0-SNAPSHOT` for testing if you add the snapshot Maven repository to your pom-file.
+
+```xml
+<repositories>
+    <repository>
+        <id>oss-snapshots-repo</id>
+        <name>Sonatype OSS Maven Repository</name>
+        <url>https://oss.sonatype.org/content/groups/public</url>
+        <releases>
+            <enabled>false</enabled>
+        </releases>
+        <snapshots>
+            <enabled>true</enabled>
+        </snapshots>
+    </repository>
+</repositories>
+```

content/about/license.md

@@ -7,7 +7,7 @@ The Pi4J Version 2.0 project is distributed and licensed under the **Apache Lice
 (_A business-friendly OSS license_).
 
 * [apache.org/licenses/LICENSE-2.0](https://www.apache.org/licenses/LICENSE-2.0)
-* [github.com/Pi4J/pi4j-v2/blob/master/LICENSE.txt](https://github.com/Pi4J/pi4j-v2/blob/master/LICENSE.txt)
+* [github.com/Pi4J/pi4j/blob/master/LICENSE.txt](https://github.com/Pi4J/pi4j/blob/master/LICENSE.txt)
 
 <div style="max-width: 650px; margin-left: auto; margin-right: auto;" >
 <pre>