feat: docs

Author: load1n9

static/content/docs/cli-reference.md

@@ -301,8 +301,7 @@ andromeda run hello.ts
 # Multiple files with dependencies
 andromeda run utils.ts main.ts
 
-# Verbose execution for debugging
-andromeda run --verbose complex-app.ts
+andromeda run complex-app.ts
 ```
 
 ### Development Workflow
@@ -311,8 +310,7 @@ andromeda run --verbose complex-app.ts
 # Format code
 andromeda fmt src/
 
-# Run with error checking
-andromeda run --verbose src/main.ts
+andromeda run src/main.ts
 
 # Test in REPL
 andromeda repl

static/content/docs/contributing.md

@@ -173,7 +173,7 @@ struct RuntimeConfig {
 const DEFAULT_TIMEOUT: Duration = Duration::from_secs(30);
 ```
 
-**Formatting**: Use `cargo fmt` to format code
+**Formatting**: Use `cargo fmt` to format code and `andromeda fmt` for TypeScript files.
 
 **Linting**: Use `cargo clippy` to check for common issues
 
@@ -228,38 +228,6 @@ cargo test --test integration
 
 ### Writing Tests
 
-#### Unit Tests
-
-```rust
-#[cfg(test)]
-mod tests {
-    use super::*;
-
-    #[test]
-    fn test_extension_registration() {
-        let mut runtime = Runtime::new();
-        let extension = TestExtension::new();
-        
-        runtime.register_extension(extension);
-        
-        assert!(runtime.has_extension("test"));
-    }
-}
-```
-
-#### Integration Tests
-
-```rust
-// tests/integration_test.rs
-use andromeda_cli::run_script;
-
-#[tokio::test]
-async fn test_script_execution() {
-    let result = run_script("examples/console.ts").await;
-    assert!(result.is_ok());
-}
-```
-
 #### TypeScript Examples
 
 Ensure examples work correctly:
@@ -366,20 +334,23 @@ git commit -m "test: add integration tests for file system"
 
    ```typescript
    // runtime/src/ext/new_api/mod.ts
-   declare global {
-     const newApi: {
-       methodName(param: string): Promise<Result>;
-     };
+   function methodName(param: string): Promise<Result> {
+       // Implementation
    }
+   // TODO: once imports are supported, use `export` syntax
    ```
 
 4. **Write tests**:
 
-   ```rust
-   #[test]
-   fn test_new_api_functionality() {
-       // Test implementation
-   }
+   ```typescript
+   // tests/new_api.test.ts
+
+   describe("New API", () => {
+       it("should return expected result", async () => {
+           const result = await methodName("test");
+           expect(result).toEqual({ success: true });
+       });
+   });
    ```
 
 5. **Add examples**:
@@ -393,7 +364,7 @@ git commit -m "test: add integration tests for file system"
 6. **Update documentation**:
    - API reference in `docs/api/`
    - Tutorial if complex
-   - Update main README if significant
+   - Update index.md if significant
 
 ### Debugging
 
@@ -415,9 +386,6 @@ rust-gdb target/debug/andromeda
 ```bash
 # Compile TypeScript separately
 cargo run -- compile script.ts
-
-# Run with verbose output
-cargo run -- run script.ts --verbose
 ```
 
 ### Performance Considerations
@@ -430,16 +398,6 @@ When contributing:
 - Consider async/await overhead
 - Test with realistic workloads
 
-```rust
-// Use criterion for benchmarks
-#[bench]
-fn bench_extension_call(b: &mut Bencher) {
-    b.iter(|| {
-        // Benchmark code
-    });
-}
-```
-
 ## Community
 
 ### Communication
@@ -506,7 +464,9 @@ Help expand platform support:
 - [Rust Programming Language](https://doc.rust-lang.org/)
 - [TypeScript Documentation](https://www.typescriptlang.org/docs/)
 - [Web APIs Standards](https://developer.mozilla.org/en-US/docs/Web/API)
-- [V8 Engine Documentation](https://v8.dev/docs)
+- [Nova Engine](https://trynova.dev)
+- [WinterTC](https://wintertc.org)
+- [Andromeda GitHub Repository](https://github.com/tryandromeda/andromeda)
 
 Thank you for contributing to Andromeda! Your efforts help make it a better
 runtime for everyone.

static/content/docs/faq.md

@@ -216,25 +216,6 @@ If Andromeda uses too much memory:
 
 Yes! Andromeda is designed to be embeddable:
 
-```rust
-use andromeda_core::Runtime;
-
-let mut runtime = Runtime::new();
-let result = runtime.execute_script("console.log('Hello from embedded Andromeda!')");
-```
-
-### Can I use Andromeda in CI/CD pipelines?
-
-Yes, Andromeda works well in CI/CD:
-
-```yaml
-# GitHub Actions example
-- name: Run tests with Andromeda
-  run: |
-    curl -L https://github.com/your-org/andromeda/releases/latest/download/andromeda-linux.tar.gz | tar xz
-    ./andromeda test-suite.ts
-```
-
 ## Comparison with Other Runtimes
 
 ### Why choose Andromeda over Deno?

static/content/docs/index.md

@@ -60,7 +60,6 @@ established web standards including:
 - **WHATWG Standards** - URL, Encoding, and Fetch specifications
 - **W3C Standards** - Canvas 2D, Performance API
 - **ECMAScript Standards** - Modern JavaScript/TypeScript features
-- **Node.js Compatibility** - Core APIs and patterns where applicable
 
 ## 🆘 Getting Help
 

static/content/docs/troubleshooting.md

@@ -137,36 +137,6 @@ Common issues and solutions for Andromeda runtime.
    andromeda run --verbose script.ts
    ```
 
-### "Module not found" errors
-
-**Problem:** Import/require statements failing.
-
-**Solutions:**
-
-1. **Use relative paths:**
-
-   ```typescript
-   // ✅ Correct
-   import { helper } from "./utils.ts";
-
-   // ❌ Incorrect (no npm modules yet)
-   import express from "express";
-   ```
-
-2. **Check file paths:**
-
-   ```bash
-   # Verify file exists
-   ls -la utils.ts
-   ```
-
-3. **Use absolute paths:**
-
-   ```typescript
-   const fullPath = Andromeda.resolve("./utils.ts");
-   console.log("Looking for:", fullPath);
-   ```
-
 ### Canvas operations failing
 
 **Problem:** Canvas API errors or black images.
@@ -190,9 +160,7 @@ Common issues and solutions for Andromeda runtime.
    // Draw something
    ctx.fillStyle = "red";
    ctx.fillRect(0, 0, 100, 100);
-
-   // Must call render before saving
-   canvas.render();
+   // Save the canvas as PNG
    canvas.saveAsPng("output.png");
    ```