docs: restructure contributing docs and improve E2E test infrastructure

Move developer resources (setup, building, testing, code quality) into
CONTRIBUTING.md and refocus the website's contributing page on project
governance (roles, voting, CLA). Slim down localgit/README.md to a
summary now that CONTRIBUTING.md covers E2E setup in detail.

Rename E2E test repositories from real project names to clearly fake
names (test-owner/test-repo, e2e-org/sample-repo). Add fail-fast
pre-flight checks in E2E setup to detect missing Docker infrastructure.
Add Docker Hub login to CI workflow to avoid pull rate limits. Remove
outdated Mocha/Chai testing page from docs site and fix plugin import
paths.

Co-Authored-By: Claude Opus 4.6 <[email protected]>

Author: coopernetes

.github/workflows/e2e.yml

@@ -41,15 +41,13 @@ jobs:
           git config --global init.defaultBranch main
 
       - name: Build and start services with Docker Compose
-        run: docker compose up -d --build
+        run: docker compose up -d --build --wait || true
 
-      - name: Wait for services to be ready
+      - name: Debug service state
+        if: always()
         run: |
-          timeout 60 bash -c '
-            while [ "$(docker compose ps | grep -c "Up")" -ne 3 ]; do
-              sleep 2
-            done
-          ' || { echo "Service readiness check failed:"; docker compose ps; exit 1; }
+          docker compose ps
+          docker compose logs
 
       - name: Run E2E tests
         run: npm run test:e2e

CONTRIBUTING.md

@@ -10,8 +10,10 @@ services:
       # If using Podman, you might need to add the :Z or :z option for SELinux
       # - ./test-e2e.proxy.config.json:/app/test-e2e.proxy.config.json:ro,Z
     depends_on:
-      - mongodb
-      - git-server
+      mongodb:
+        condition: service_healthy
+      git-server:
+        condition: service_healthy
     networks:
       - git-network
     environment:
@@ -30,6 +32,12 @@ services:
       #   - Comma-separated list = 'http://localhost:3000,https://example.com'
       #   - Unset/empty = Same-origin only (most secure)
       - ALLOWED_ORIGINS=
+    healthcheck:
+      test: ['CMD-SHELL', 'curl -sf http://localhost:8081/api/v1/healthcheck || exit 1']
+      interval: 5s
+      timeout: 5s
+      retries: 12
+      start_period: 10s
   mongodb:
     image: mongo:7@sha256:606f8e029603330411a7dd10b5ffd50eefc297fc80cee89f10a455e496a76ae7
     ports:
@@ -40,6 +48,12 @@ services:
       - MONGO_INITDB_DATABASE=gitproxy
     volumes:
       - mongodb_data:/data/db
+    healthcheck:
+      test: ['CMD', 'mongosh', '--eval', "db.adminCommand('ping')"]
+      interval: 5s
+      timeout: 5s
+      retries: 12
+      start_period: 5s
 
   git-server:
     build: localgit/
@@ -50,6 +64,16 @@ services:
     networks:
       - git-network
     hostname: git-server
+    healthcheck:
+      test:
+        [
+          'CMD-SHELL',
+          'GIT_TERMINAL_PROMPT=0 GIT_SSL_NO_VERIFY=1 git ls-remote https://admin:admin123@localhost:8443/test-owner/test-repo.git HEAD || exit 1',
+        ]
+      interval: 5s
+      timeout: 5s
+      retries: 12
+      start_period: 5s
 
 networks:
   git-network: