made sure every nav points to file, edited a lot of content to map www/docs and this docs repo

Author: antedotee

build_all.py

@@ -4,13 +4,18 @@
 
 This script builds the documentation for all configured languages
 (English, Spanish, Portuguese, and Brazilian Portuguese).
+
+Before building, runs scripts/verify_docs_nav.py (every .md is listed in nav).
+After a successful build, runs scripts/verify_docs_rendered.py (every .md has HTML output).
 """
 
 import subprocess
 import sys
 from pathlib import Path
 
 ROOT = Path(__file__).parent
+VERIFY_NAV = ROOT / "scripts" / "verify_docs_nav.py"
+VERIFY_RENDERED = ROOT / "scripts" / "verify_docs_rendered.py"
 CONFIG_FILES = [
     "zensical.toml",       # English
     "zensical.es.toml",    # Spanish
@@ -49,7 +54,20 @@ def run_command(cmd, description):
 def main():
     print("🌍 Building omegaUp Documentation - All Languages")
     print(f"📂 Working directory: {ROOT}")
-    
+
+    if not VERIFY_NAV.is_file():
+        print(f"❌ Missing {VERIFY_NAV.name}; cannot verify navigation coverage.")
+        return 1
+    if not run_command(
+        [PYTHON, str(VERIFY_NAV)],
+        "Verifying nav covers every markdown page (all locales)",
+    ):
+        print(
+            "\nFix orphan pages in zensical*.toml, then rebuild. "
+            "See scripts/verify_docs_nav.py for rules."
+        )
+        return 1
+
     # Clean the site directory first
     print("\n🧹 Cleaning site directory...")
     site_dir = ROOT / "site"
@@ -105,25 +123,38 @@ def main():
     index_file = ROOT / "site" / "index.html"
     index_file.write_text(redirect_html, encoding="utf-8")
     print("   Created site/index.html redirect")
-    
+
     # Summary
     print("\n" + "="*60)
     if failures:
-        print(f"⚠️  Build completed with errors")
+        print("⚠️  Build completed with errors")
         print(f"   Failed languages: {', '.join(failures)}")
         return 1
-    else:
-        print("✅ All language versions built successfully!")
-        print("\n📚 Available languages:")
-        print("   • English:              site/en/")
-        print("   • Español:              site/es/")
-        print("   • Português:            site/pt/")
-        print("   • Português (Brasil):   site/pt-BR/")
-        print("\n🚀 To serve locally, run:")
-        print("   python3 serve_multilang.py")
-        print("   or")
-        print("   cd site && python3 -m http.server 8000")
-        return 0
+
+    if not VERIFY_RENDERED.is_file():
+        print(f"❌ Missing {VERIFY_RENDERED.name}; cannot verify rendered HTML.")
+        return 1
+    if not run_command(
+        [PYTHON, str(VERIFY_RENDERED)],
+        "Verifying every markdown page produced HTML (all locales)",
+    ):
+        print(
+            "\nSome source pages are missing from site/. "
+            "See scripts/verify_docs_rendered.py."
+        )
+        return 1
+
+    print("✅ All language versions built successfully!")
+    print("\n📚 Available languages:")
+    print("   • English:              site/en/")
+    print("   • Español:              site/es/")
+    print("   • Português:            site/pt/")
+    print("   • Português (Brasil):   site/pt-BR/")
+    print("\n🚀 To serve locally, run:")
+    print("   python3 serve_multilang.py")
+    print("   or")
+    print("   cd site && python3 -m http.server 8000")
+    return 0
 
 if __name__ == "__main__":
     try:

docs/en/api/index.md

@@ -114,6 +114,14 @@ Error responses:
 }
 ```
 
+## Complete endpoint catalog
+
+This site documents the main API **categories** in detail. The wiki used to duplicate a very long flat list of every `/api/...` path; the **generated, authoritative index** of controllers and routes lives in the main repository:
+
+**[frontend/server/src/Controllers/README.md](https://github.com/omegaup/omegaup/blob/main/frontend/server/src/Controllers/README.md)**
+
+Routing convention: a request to `/api/<segment>/<action>/` is handled by `<Segment>Controller::api<Action>` in `frontend/server/src/Controllers/` (with the usual PHP naming adjustments). Use the generated README for exact method names and parameters while developing.
+
 ## Rate Limiting
 
 Some endpoints have rate limits to prevent abuse:

docs/en/api/rest-api.md

@@ -91,6 +91,10 @@ Returns the current UNIX timestamp according to the server's internal clock. Use
 
 **Required Permissions:** None
 
+## Complete endpoint catalog
+
+For an **exhaustive** list of API methods grouped by controller, see the auto-generated **[Controllers README](https://github.com/omegaup/omegaup/blob/main/frontend/server/src/Controllers/README.md)** in the omegaUp repository. The human-written pages here (`users.md`, `contests.md`, …) focus on the most common flows; the README is the best reference when you need a specific `apiSomething` name.
+
 ## Rate Limiting
 
 Some endpoints have rate limits:

docs/en/architecture/index.md

@@ -119,7 +119,7 @@ flowchart TD
 When a user submits code, here's what happens:
 
 1. **Frontend** sends HTTP POST to `/api/run/create/`
-2. **Nginx** forwards request to PHP (HHVM)
+2. **Nginx** forwards the request to **PHP** (PHP-FPM in typical setups)
 3. **Bootstrap** loads configuration and initializes database
 4. **Controller** (`RunController::apiCreate`) processes request
 5. **Authentication** validates user token

docs/en/architecture/internals.md

@@ -39,7 +39,7 @@ sequenceDiagram
 When a submission is made:
 
 1. Code, contest alias, problem, and language sent via HTTP POST to `/api/run/create/`
-2. Nginx forwards to PHP (HHVM)
+2. Nginx forwards the request to **PHP** (PHP-FPM in typical deployments; the entrypoint loads `frontend/server/bootstrap.php`)
 3. `bootstrap.php` loads configuration and initializes database
 4. `Request` object created with parameters
 5. URL tokenized: `/api/run/create/` → `['run', 'create']`
@@ -57,6 +57,7 @@ The controller:
    - Contest time limit not expired
    - Submission rate limit (60 seconds per problem)
    - Contest visibility (public or user listed)
+   - **Lockdown mode** (when enabled): extra checks apply—for example, blocking submissions that would count as **practice mode** when the platform is locked down for a contest window
 4. Calculates penalty based on contest policy
 5. Generates random GUID
 6. Stores submission in database

docs/en/architecture/security.md

@@ -115,6 +115,7 @@ Third-party authentication via:
 
 - **Google**: OAuth 2.0 with ID token verification
 - **Facebook**: OAuth 2.0 with access token
+- **GitHub** (optional in production; common in **local dev**): configure `OMEGAUP_GITHUB_CLIENT_ID` / `OMEGAUP_GITHUB_CLIENT_SECRET` in `frontend/server/config.php` — see the **GitHub OAuth** section in [Development setup](../../getting-started/development-setup.md)
 
 ```mermaid
 sequenceDiagram