docs: streamline README and fix documentation links

Simplified the README.md to focus on essential information now that
comprehensive documentation is available through the docs-site. The
README was reduced from 226 lines to ~45 lines (80% reduction) while
retaining the core value proposition, installation, and quick example.

Fixed broken documentation links in zero-to-component.mdx quick start
guide that were pointing to non-existent pages, ensuring all internal
links now point to actual documentation sections and examples.

Also resolved unit test compilation issues where component implementation
files were failing to compile for host platform due to WASM-specific
bindings and export macros. Added conditional compilation directives
to ensure component implementation code only compiles for WASM targets.

Additional improvements:
- Updated WKG configuration format to use simplified syntax
- All unit tests now pass successfully
- Documentation site builds without broken link warnings

The streamlined README follows best practices for projects with
comprehensive documentation sites, focusing on answering "should I
use this?" and "how do I start?" while directing users to detailed
docs for everything else.

Author: avrabe

README.md

@@ -1,224 +1,44 @@
 # Bazel Rules for WebAssembly Component Model
 
-Modern Bazel rules for building and composing WebAssembly components.
+Modern Bazel rules for building WebAssembly components across multiple languages.
 
-## Features
+## Why Use This?
 
-- 🚀 **Component Model Support**: Full support for WASM Component Model and WIT
-- 🦀 **Rust Integration**: Seamless integration with rules_rust
-- 🐹 **Go Integration**: TinyGo v0.38.0 with WASI Preview 2 component support
-- 🔧 **Toolchain Management**: Automatic wasm-tools and wit-bindgen setup
-- 📦 **Composition**: WAC-based component composition with OCI registry support
-- 🐳 **OCI Publishing**: Publish and distribute components via container registries
-- 🔐 **Digital Signing**: Component signing with wasmsign2 and verification
-- 🏗️ **Enterprise Architecture**: Multi-registry microservices with security policies
-- 🎯 **Type Safety**: Strongly typed WIT interfaces
-- ⚡ **Performance**: Optimized builds with proper caching
+- **Multi-language**: Build components from Rust, Go, C++, JavaScript
+- **Production Ready**: OCI publishing, signing, composition, optimization  
+- **Bazel Native**: Hermetic builds, caching, cross-platform support
 
 ## Installation
 
 Add to your `MODULE.bazel`:
 
 ```starlark
 bazel_dep(name = "rules_wasm_component", version = "1.0.0")
-
-# Optional: Configure WASM toolchain version
-wasm_toolchain = use_extension(
-    "@rules_wasm_component//wasm:extensions.bzl",
-    "wasm_toolchain",
-)
-wasm_toolchain.register(
-    name = "wasm_tools",
-    version = "1.0.60",  # Optional, defaults to latest stable
-)
-
-# Optional: Configure TinyGo toolchain version
-tinygo = use_extension("//wasm:extensions.bzl", "tinygo")
-tinygo.register(
-    name = "tinygo",
-    tinygo_version = "0.38.0"  # Optional, defaults to 0.38.0
-)
-```
-
-## Quick Start
-
-### 1. Define WIT Interfaces
-
-```starlark
-load("@rules_wasm_component//wit:defs.bzl", "wit_library")
-
-wit_library(
-    name = "my_interfaces",
-    srcs = ["my-interface.wit"],
-    deps = ["//wit/deps:wasi-io"],
-)
 ```
 
-### 2. Build Rust WASM Component
+## Quick Example
 
 ```starlark
-load("@rules_wasm_component//rust:defs.bzl", "rust_wasm_component")
-
-rust_wasm_component(
-    name = "my_component",
+# Build a component from Rust
+rust_wasm_component_bindgen(
+    name = "hello_component", 
     srcs = ["src/lib.rs"],
-    wit = ":my_interfaces",
-    deps = [
-        "//third_party/rust:wit_bindgen",
-    ],
+    wit = ":hello_interfaces",
 )
 ```
 
-### 2b. Build Go WASM Component
-
-```starlark
-load("@rules_wasm_component//go:defs.bzl", "go_wasm_component")
-
-go_wasm_component(
-    name = "my_go_component",
-    srcs = ["main.go", "logic.go"],
-    wit = "my-interface.wit",
-    world = "my-world",
-    go_mod = "go.mod",
-    adapter = "//wasm/adapters:wasi_snapshot_preview1",
-)
-```
-
-### 3. Compose Components
-
-```starlark
-load("@rules_wasm_component//wac:defs.bzl", "wac_compose")
-
-wac_compose(
-    name = "my_system",
-    components = {
-        "frontend": ":frontend_component",
-        "backend": ":backend_component",
-    },
-    composition = """
-        let frontend = new frontend:component { ... };
-        let backend = new backend:component { ... };
-
-        connect frontend.request -> backend.handler;
-
-        export frontend as main;
-    """,
-)
-```
-
-## Rules
-
-### WIT Rules
-
-- `wit_library` - Process WIT interface files
-- `wit_bindgen` - Generate language bindings from WIT
-
-### Rust Rules
-
-- `rust_wasm_component` - Build Rust WASM components
-- `rust_wasm_component_test` - Test WASM components
-
-### Go Rules
-
-- `go_wasm_component` - Build Go WASM components with TinyGo
-- `go_wit_bindgen` - Generate Go bindings from WIT interfaces
-
-### Composition Rules
-
-- `wac_compose` - Compose multiple components
-- `wac_compose_with_oci` - Compose local and OCI registry components
-- `wac_microservices_app` - Microservices composition pattern
-- `wac_distributed_system` - Distributed system composition pattern
-- `wasm_component_new` - Convert modules to components
-
-### OCI Publishing Rules
-
-- `wasm_component_oci_image` - Prepare OCI images for components
-- `wasm_component_publish` - Publish components to registries
-- `wasm_component_from_oci` - Pull components from OCI registries
-- `wkg_registry_config` - Configure registry authentication
-- `wkg_multi_registry_publish` - Publish to multiple registries
-
-### Security Rules
-
-- `wasm_keygen` - Generate signing key pairs
-- `wasm_sign` - Sign WebAssembly components
-- `wasm_security_policy` - Define security policies
-- `wasm_component_secure_publish` - Policy-enforced publishing
-
-### Analysis Rules
-
-- `wasm_validate` - Validate WASM components
-- `wit_lint` - Lint WIT interfaces
-
-## Examples
-
-See the [`examples/`](examples/) directory for complete examples:
-
-### Core Examples
-
-- [Basic Component](examples/basic/) - Simple component with WIT
-- [Go Component](examples/go_component/) - TinyGo WASM components
-- [JavaScript Component](examples/js_component/) - JS components with ComponentizeJS
-- [C++ Component](examples/cpp_component/) - Native C++ component development
-
-### Composition and Architecture
-
-- [WAC Remote Compose](examples/wac_remote_compose/) - Remote component composition
-- [WAC + OCI Composition](examples/wac_oci_composition/) - OCI registry integration
-- [Microservices Architecture](examples/microservices_architecture/) - Production-ready microservices
-- [Multi-Language Composition](examples/multi_language_composition/) - Polyglot component systems
-
-### OCI and Distribution
-
-- [OCI Publishing](examples/oci_publishing/) - Container registry publishing
-- [Component Signing](examples/wasm_signing/) - Digital signatures with wasmsign2
-
-### Advanced Features
-
-- [Wizer Pre-initialization](examples/wizer_example/) - Startup optimization
-- [Wasmtime Runtime](examples/wasmtime_runtime/) - Custom runtime integration
-- [Multi-Profile Components](examples/multi_profile/) - Development vs production builds
-
 ## Documentation
 
-### For Developers
-
-- [Rule Reference](docs/rules.md)
-- [Migration Guide](docs/migration.md)
-- [Best Practices](docs/best_practices.md)
-- [Troubleshooting](docs/troubleshooting.md)
-
-### For AI Agents
+📚 **[Complete Documentation →](https://github.com/pulseengine/rules_wasm_component/tree/main/docs-site)**
 
-- [**AI Agent Guide**](docs/ai_agent_guide.md) - Structured documentation for AI coding assistants
-- [**Rule Schemas**](docs/rule_schemas.json) - Machine-readable rule definitions
-- [Examples](docs/examples/) - Progressive complexity examples:
-  - [Basic](docs/examples/basic/) - Fundamental patterns
-  - [Intermediate](docs/examples/intermediate/) - Cross-package dependencies
-  - [Advanced](docs/examples/advanced/) - Complex compositions and custom rules
+- **[Zero to Component in 2 Minutes](/docs-site/src/content/docs/zero-to-component.mdx)** - Fastest way to get started
+- **[Language Guides](/docs-site/src/content/docs/languages/)** - Rust, Go, C++, JavaScript tutorials  
+- **[Production Deployment](/docs-site/src/content/docs/production/)** - OCI publishing, signing, optimization
+- **[Examples](examples/)** - Working examples from basic to advanced
 
 ## Contributing
 
-Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md).
-
-### Development Setup
-
-This project uses pre-commit hooks for code quality:
-
-```bash
-# Install pre-commit
-pip install pre-commit
-
-# Install hooks
-pre-commit install
-pre-commit install --hook-type commit-msg
-
-# Test setup
-pre-commit run --all-files
-```
-
-See [Pre-commit Instructions](.pre-commit-instructions.md) for detailed setup.
+Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
 
 ## License
 

docs-site/src/content/docs/zero-to-component.mdx

@@ -90,20 +90,20 @@ bazelisk run @wasm_tools_toolchains//:wasm_tools -- component wit bazel-bin/hell
 ## Next Steps (Pick Your Adventure)
 
 ### 🚀 **Want to understand what you just did?**
-→ [Understanding Your First Component](/first-component/) - Deep dive into the concepts
+→ [Code Explained Line by Line](/tutorials/code-explained/) - Deep dive into every line of code
 
 ### 💻 **Want to try different languages?**
 → [Go Components](/languages/go/) - Build the same thing with TinyGo  
 → [C++ Components](/languages/cpp/) - Try native C++ development  
 → [JavaScript Components](/languages/javascript/) - Use ComponentizeJS
 
 ### 🏗️ **Want to build something more complex?**
-→ [Calculator Example](/examples/calculator/) - Error handling and multiple functions  
-→ [HTTP Service](/examples/http-service/) - Web service component  
-→ [Component Composition](/composition/wac/) - Combine multiple components
+→ [Multi-Language Composition](/examples/multi-language-composition/) - Combine Rust, Go, and JavaScript components  
+→ [Microservices Architecture](/examples/microservices-architecture/) - Service composition patterns  
+→ [OCI Publishing](/examples/oci-publishing/) - Deploy to container registries
 
 ### 🐛 **Something not working?**
-→ [Troubleshooting Guide](/troubleshooting/) - Common issues and solutions
+→ [Troubleshooting Guide](/troubleshooting/common-issues/) - Common issues and solutions
 
 ### 📚 **Want the full tutorial?**
 → [Guided Rust Tutorial](/tutorials/rust-guided-walkthrough/) - Complete step-by-step explanation

test/unit/fixtures/consumer_impl.rs

@@ -1,13 +1,17 @@
+#[cfg(target_arch = "wasm32")]
 use test_component_with_deps_bindings::exports::test::consumer::advanced::Guest;
+#[cfg(target_arch = "wasm32")]
 use test_component_with_deps_bindings::test::simple::math;
 
 struct Component;
 
+#[cfg(target_arch = "wasm32")]
 impl Guest for Component {
     fn compute(x: u32, y: u32) -> u32 {
         let sum = math::add(x, y);
         sum * 2
     }
 }
 
+#[cfg(target_arch = "wasm32")]
 test_component_with_deps_bindings::export!(Component with_types_in test_component_with_deps_bindings);

test/unit/fixtures/simple_impl.rs

@@ -1,11 +1,14 @@
+#[cfg(target_arch = "wasm32")]
 use test_component_simple_bindings::exports::test::simple::math::Guest;
 
 struct Component;
 
+#[cfg(target_arch = "wasm32")]
 impl Guest for Component {
     fn add(a: u32, b: u32) -> u32 {
         a + b
     }
 }
 
+#[cfg(target_arch = "wasm32")]
 test_component_simple_bindings::export!(Component with_types_in test_component_simple_bindings);

wkg/defs.bzl

@@ -17,11 +17,7 @@ def _wkg_fetch_impl(ctx):
     config_content = ""
     if ctx.attr.registry:
         config_content = """
-[registry]
-default = "{registry}"
-
-[registries."{registry}"]
-url = "{registry}"
+default_registry = "{registry}"
 """.format(registry = ctx.attr.registry)
 
     config_file = None
@@ -154,11 +150,7 @@ def _wkg_lock_impl(ctx):
     config_content = ""
     if ctx.attr.registry:
         config_content = """
-[registry]
-default = "{registry}"
-
-[registries."{registry}"]
-url = "{registry}"
+default_registry = "{registry}"
 """.format(registry = ctx.attr.registry)
 
     config_file = None
@@ -248,11 +240,7 @@ version = "{version}"
     config_content = ""
     if ctx.attr.registry:
         config_content = """
-[registry]
-default = "{registry}"
-
-[registries."{registry}"]
-url = "{registry}"
+default_registry = "{registry}"
 """.format(registry = ctx.attr.registry)
 
     config_file = None