docs: simplified contribution guide

.github/CONTRIBUTING.md

@@ -1,243 +1,72 @@
 # Contributing to lerobot.js
 
-Thanks for your interest in contributing! This guide will help you get started.
-
-## 🚀 Quick Start
+## Quick Start
 
 ```bash
-# Clone and setup
 git clone https://github.com/timpietrusky/lerobot.js.git
 cd lerobot.js
 pnpm install
-
-# Run cyberpunk demo (recommended)
-pnpm example:cyberpunk
-
-# Build packages
-pnpm --filter "@lerobot/web" run build
 ```
 
-## 📦 Package Structure
-
-- **`packages/web/`** - Browser package (`@lerobot/web` on npm)
-- **`examples/cyberpunk-standalone/`** - Main demo application (standalone)
-- **`examples/iframe-dialog-test/`** - Test application for iframe integration
-- **`examples/test-sequential-operations/`** - Sequential operations test
-- **`src/cli/`** - Node.js CLI tool
-- **`src/lerobot/node/`** - Node.js library implementation
+## Development
 
-## 🔄 Making Changes
+### Library + Demo Development (Recommended)
 
-### 1. Development Workflow
-
-**For Web Library Changes:**
+**Terminal 1:**
 
 ```bash
 cd packages/web
-pnpm dev      # Run tests in watch mode
-pnpm build    # Build the library
+pnpm build:watch
 ```
 
-**For Example/Demo Changes:**
+**Terminal 2:**
 
 ```bash
-pnpm example:cyberpunk      # Main demo
-pnpm example:iframe-test    # Other examples
-pnpm example:sequential-test
+cd examples/cyberpunk-standalone
+npm run dev
 ```
 
-**For CLI Changes:**
+Edit `packages/web/src/` → see changes instantly in demo.
 
-```bash
-pnpm cli:find-port     # Test CLI commands
-pnpm cli:calibrate
-pnpm cli:teleoperate
-pnpm build            # Build CLI for distribution
-```
-
-### 2. Creating a Changeset
-
-**For any changes to `packages/web/`:**
+### Library Only
 
 ```bash
-# Describe your changes
-pnpm changeset
+cd packages/web
+pnpm build    # Build once
+pnpm dev      # Tests in watch mode
 ```
 
-- **Select package**: `@lerobot/web`
-- **Version type**:
-  - `patch` (0.1.1 → 0.1.2) - Bug fixes
-  - `minor` (0.1.1 → 0.2.0) - New features
-  - `major` (0.1.1 → 1.0.0) - Breaking changes
-- **Summary**: Clear description for changelog
-
-### 3. Submit Pull Request
+### Examples Only
 
 ```bash
-git add .
-git commit -m "feat: your change description"
-git push origin your-branch
+pnpm example:cyberpunk
+pnpm example:iframe-test
+pnpm example:sequential-test
 ```
 
-Create a PR with:
-
-- Clear description of changes
-- Reference any related issues
-- Include changeset if modifying `@lerobot/web`
+## Releases
 
-## 🚀 Release Process
-
-### Automated Releases (Recommended)
-
-1. **Changeset added** → PR merged to `main`
-2. **GitHub Actions** creates Release PR automatically
-3. **Maintainer merges** Release PR
-4. **Package published** to npm with GitHub release
-
-### Manual Testing
+For `@lerobot/web` changes:
 
 ```bash
-# Preview version changes (safe)
-pnpm changeset:version
-
-# Publish manually (only for emergencies)
-pnpm changeset:publish
+pnpm changeset
 ```
 
-## 📋 Code Standards
-
-### TypeScript
+Select package, version type (patch/minor/major), add description.
 
-- Use strict TypeScript settings
-- Export types explicitly
-- Document public APIs with JSDoc
-
-### Code Style
+## Code Standards
 
 - Follow existing patterns
-- Use meaningful variable names
-- Add comments for complex logic
-- **NO explanation comments** in code (see `docs/conventions.md`)
+- Use TypeScript strict mode
+- No explanation comments (see `docs/conventions.md`)
 
-### Commit Messages
+## Commit Format
 
 - `feat:` - New features
 - `fix:` - Bug fixes
 - `docs:` - Documentation
 - `chore:` - Maintenance
-- `refactor:` - Code restructuring
-
-## 🧪 Testing
-
-### Manual Testing
-
-```bash
-# Test demo locally
-pnpm dev
-
-# Test CLI
-pnpm cli:find-port
-pnpm cli:calibrate
-
-# Test package build
-pnpm --filter "@lerobot/web" run build
-```
-
-### Hardware Testing
-
-- Use SO-100 leader/follower arms when available
-- Test calibration, teleoperation, port discovery
-- Verify WebSerial API compatibility
-
-## 📝 Documentation
-
-### Update Documentation For:
-
-- New functions in `@lerobot/web`
-- CLI command changes
-- Hardware support additions
-- Breaking changes
-
-### Files to Update:
-
-- `packages/web/README.md` - Package documentation
-- `README.md` - Main project overview
-- JSDoc comments for new APIs
-
-## 🐛 Bug Reports
-
-Include:
-
-- Steps to reproduce
-- Expected vs actual behavior
-- Browser/Node.js version
-- Hardware setup (if relevant)
-- Error messages/console output
-
-## 💡 Feature Requests
-
-- Explain the use case
-- Provide examples if possible
-- Consider backward compatibility
-- Discuss implementation approach
-
-## 🎯 Areas for Contribution
-
-### High Priority
-
-- New robot hardware support
-- Browser compatibility improvements
-- Performance optimizations
-- Documentation improvements
-
-### Medium Priority
-
-- Additional calibration methods
-- UI/UX enhancements
-- CLI tool features
-- Testing infrastructure
-
-### Advanced
-
-- WebRTC integration
-- Computer vision features
-- Machine learning integration
-- Protocol implementations
-
-## 🔧 Development Tips
-
-### Common Commands
-
-```bash
-# Install dependencies
-pnpm install
-
-# Start demo development
-pnpm dev
-
-# Build everything
-pnpm build
-
-# Create changeset
-pnpm changeset
-
-# Work with specific package
-pnpm --filter "@lerobot/web" run build
-```
-
-### Debugging
-
-- Use browser DevTools for WebSerial issues
-- Check console for hardware communication errors
-- Use `console.log` for motor position debugging
-- Test with different hardware configurations
-
-## 📞 Getting Help
-
-- **Issues**: Use GitHub issues for bugs/features
-- **Discussions**: Use GitHub discussions for questions
-- **Hardware**: Check hardware documentation in `docs/`
 
-## 🙏 Recognition
+## Bug Reports
 
-All contributors will be recognized in releases and project documentation. Thank you for helping make robotics more accessible! 🤖✨
+Include: steps to reproduce, expected vs actual behavior, browser/Node version, hardware setup, error messages.