feat (docs): Clarify state of Development Containers support

Author: vorburger

.github/workflows/ci.yaml

@@ -34,15 +34,14 @@ concurrency:
 
 jobs:
   devcontainer:
-    # https://github.com/orgs/community/discussions/25722
     if:
       (github.repository == 'enola-dev/enola') &&
       (github.event.pull_request.draft == false)
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
       - name: DevContainer
-        # TODO if: ${{ github.event_name == 'push' }}
+        # if: ${{ github.event_name == 'push' }}
         uses: devcontainers/[email protected]
         with:
           # TODO imageName: ghcr.io/example/example-devcontainer
@@ -53,7 +52,6 @@ jobs:
           # TODO runCmd: ./tools/test-ci/test.bash
 
   build:
-    # https://github.com/orgs/community/discussions/25722
     if:
       (github.repository == 'enola-dev/enola') &&
       (github.event.pull_request.draft == false)

docs/dev/ide.md

@@ -20,6 +20,13 @@
 
 Ensure you are [set-up](setup.md) with a working build on the CLI before configuring your IDE.
 
+!!! failure "VSC broken for Java development"
+
+    [Use only IntelliJ](#jetbrains-intellij-idea-ij) for Java development, until
+    [bazel-vscode-java#114](https://github.com/salesforce/bazel-vscode-java/issues/114) is fixed.
+
+    For `web/` development, and documentation writing, you can still use VSC etc.
+
 ## GitHub Codespaces
 
 [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/enola-dev/enola?quickstart=1)

docs/dev/setup.md

@@ -18,6 +18,22 @@
 
 # Dev Set-Up
 
+## DevContainers
+
+This project [aims to](https://github.com/enola-dev/enola/issues/180) eventually (only) use & support [Development Containers](https://containers.dev/). The current state is:
+
+* For Doc & Web, [not Java](https://github.com/salesforce/bazel-vscode-java/issues/114), with VSC-based:
+  * GitHub CodeSpaces works (?)
+  * Visual Studio Code with [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) works on Ubuntu (?), but [not Fedora](https://github.com/microsoft/vscode-remote-release/issues/10681)
+* JetBrains Family
+  * On Fedora, use IntelliJ IDEA 2025.1 EAP instead of 2024.3.2.2, due to [IJPL-173883](https://youtrack.jetbrains.com/issue/IJPL-173883)
+  * TODO File IntelliJ bug re. _"sh: 1: /workspaces/enola/tools/devcontainer/install.bash: not found"_ problem?
+* https://devpod.sh:
+  * [Broken](https://github.com/enola-dev/enola/issues/1038) TODO Debug...
+  * [AppImage does not work on Fedora 41](https://github.com/loft-sh/devpod/issues/1410); but the Targz ([after](https://github.com/loft-sh/devpod/pull/1618) a `sudo dnf install libappindicator-gtk3`) at least starts
+  * TODO Try CLI?
+* There is some CI "coverage", which would detect major problems, but cannot catch problems such as those listed above.
+
 ## GitHub Codespaces
 
 **We highly recommend you use our ready-made "1 click" [Web/Cloud IDE](ide.md) set-up.**