Merge pull request #7769 from kamranayub/kamranayub/contributing

fix: Update Dev Container and CONTRIBUTING guidelines

Author: wmertens

.devcontainer/Dockerfile

@@ -1,4 +1,4 @@
-FROM cimg/rust:1.73-node
+FROM cimg/rust:1.88.0-node
 
 RUN rustup --version; \
     cargo --version; \

CONTRIBUTING.md

@@ -69,7 +69,7 @@ You need to have these tools up and running in your local machine:
 - one of the following:
   - [Nix](https://nixos.org)
   - [Docker](https://www.docker.com/)
-  - Locally installed NodeJS v18+ and optionally Rust
+  - Locally installed NodeJS v22+ and optionally Rust
 
 #### Nix
 
@@ -95,6 +95,15 @@ Alternatively you can use [devcontainers/cli](https://github.com/devcontainers/c
 - In your terminal navigate to the Qwik's project root directory.
 - Then run `devcontainer up --workspace-folder .`. This command will start a Docker container with all required environment dependencies.
 
+> [!TIP]
+> If you are using Podman, be sure to update the [VSCode dev container settings](https://code.visualstudio.com/remote/advancedcontainers/docker-options#_podman). Don't forget to allocate enough resources to the Podman machine to avoid slow builds.
+
+> [!NOTE]
+> You may run into an `EEXISTS` error when the Dev Container runs the "updateContentCommand" script. This may happen if pnpm gets installed automatically during the setup process. You can ignore the error because the container will be setup correctly, then run `pnpm install` in the project root once the container is connected and the terminal is available.
+
+> [!CAUTION]
+> The Dev Container may not work on Windows properly due to a difference with Windows container host volume permissions and ownership. It's recommended to use Mac or Linux instead, or configure your environment to build the project without Dev Containers.
+
 ##### Using development container without Dev Containers and VSCode
 
 If you would like to make use of the development container solution, but don't use VSCode or Dev Containers, you still can do so, by following steps:
@@ -145,7 +154,7 @@ Furthermore, to build the optimizer you optionally need Rust.
 
 1. Make sure [Rust](https://www.rust-lang.org/tools/install) is installed.
 2. Install [wasm-pack](https://rustwasm.github.io/wasm-pack/installer/) with `cargo install wasm-pack` .
-3. Node version >= `18`.
+3. Node version >= `22`.
 4. Make sure you have [pnpm](https://pnpm.io/installation) installed.
 5. run `pnpm install`
 
@@ -164,6 +173,9 @@ pnpm install && pnpm build.local
 
 If you want to work on the Rust code, use `build.full` instead of `build.local`.
 
+> [!NOTE]
+> After running `build.local`, you may see Git diffs for API-related files and `JSXNode`. You should run the `api.update` script to resolve them.
+
 ### Fast build
 
 This will build only Qwik and Qwik City and their types. This is not enough to run the docs.