Merge branch 'main' into fix/750-small-cleanup

README.adoc

@@ -27,6 +27,20 @@ Among many link:documentation/alternatives.adoc[alternatives] we believe IDEasy
 Not yet convinced?
 See link:documentation/features.adoc[features].
 
+== Status
+
+NOTE: Currently IDEasy is in beta state so it is not yet considered to be production ready. Do not use it with large teams or otherwise do not blame us if your team gets blocked by a bug.
+
+We are planning to go out of beta beginning of 2025.
+However, this will only include support for Windows while official Linux and Mac support will come later in 2025 (see e.g. bug https://github.com/devonfw/IDEasy/issues/589[#589] or https://github.com/devonfw/IDEasy/issues/451[#451]).
+Further, you should contact us if you plan to use IDEasy in your project with a real developer team.
+We will have a look at your demands and can give you the latest insights about features working stable and edge-cases that might still cause problems.
+Do not expect reasoable support if you started with IDEasy in 2024 with a large team but without getting in touch.
+We surely try to fix bugs as soon as possible but we do not work extra shifts or prioritize your issues if you are blocked and we never promised any help before.
+Also, if you are currently working with devonfw-ide, please stay patient.
+You can surely do a pilot where one developer tries to work with IDEasy in your devonfw-ide project and see if all works fine or better.
+But unless we update this status and officially annouce that devonfw-ide shall be replaced with IDEasy you should not push this ahead with your developer teams.
+
 == Setup
 
 === Prerequisites
@@ -38,6 +52,10 @@ All you need before installing IDEasy is https://git-scm.com/download/[git].
 Download the latest version of `IDEasy` from https://github.com/devonfw/IDEasy/releases[here] and install it.
 (You can find all Releases in https://repo.maven.apache.org/maven2/com/devonfw/tools/IDEasy/ide-cli/[Maven Central])
 
+NOTE: We are working on an installer (see e.g. https://github.com/devonfw/IDEasy/issues/420[#420]) that will guide you thorugh the installation.
+Currently you need to create an `projects/_ide` in your home directory or on `C:\` or `D:`, extract the downloaded archive directly into that `_ide` folder and run the `setup` script (`setup.bat` on Windows).
+To install an update manually, you just need to extract the new archive content into that `_ide` folder (e.g. with 7-Zip) overwriting all existing files.
+
 === Create projects
 
 Once installed, you can setup a new project with the following command:

documentation/software.adoc

@@ -49,4 +49,4 @@ This will download and extract the following content to your `software` folder:
 * `https://some-file-server.company.com/projects/my-project/jboss-eap/7.1.4.GA/jboss-eap-7.1.4.GA.tgz`
 * `https://some-file-server.company.com/projects/my-project/firefox/70.0.1/firefox-70.0.1-windows-x64.tgz`
 
-Please note that if you are not using windows, the `-windows` suffix will be `-mac` or `-linux`.
+Please note that if you are not using windows, the `-windows` suffix will be `-mac` or `-linux` and instead of `x64` you could get `arm` (e.g. for Mac M1+ CPU).