Cleanup docs

Author: kush-duolingo

README.md

@@ -45,9 +45,9 @@ All `docker_image` entries found in `.pre-commit-config.yaml` will be included,
 This hook synchronizes AI coding rules from `.cursor/rules/` and `.code_review/` directories to AI assistant configuration files (CLAUDE.md, AGENTS.md, .github/copilot-instructions.md). It generates two sections:
 
 - **Development Rules** - from `.cursor/rules/*.mdc` files with YAML frontmatter
-- **Review Guidelines** - from `.code_review/*.md` files with HTML comment frontmatter
+- **Code Review Guidelines** - from `.code_review/*.md` files with HTML comment frontmatter
 
-This ensures all AI coding assistants stay aware of the same rules and conventions.
+This ensures all AI coding assistants stay aware of the same rules and coding conventions.
 
 ## Usage
 

sync_ai_rules/README.md

@@ -1,11 +1,11 @@
 # sync-ai-rules
 
-Synchronizes AI coding rules to configuration files for Claude, GitHub Copilot, and other AI assistants. Parses rules from source directories and generates documentation sections automatically.
+Synchronizes AI rules to configuration files for Claude, GitHub Copilot, and other AI assistants. Parses rules from source directories and generates documentation sections automatically.
 
 ## Supported Formats
 
 - **Development Rules** - `.cursor/rules/*.mdc` files (YAML frontmatter) → Development Rules section
-- **Review Guidelines** - `.code_review/*.md` files (HTML comment frontmatter) → Review Guidelines section
+- **Code Review Guidelines** - `.code_review/*.md` files (HTML comment frontmatter) → Code Review Guidelines section
 
 Target files: `CLAUDE.md`, `AGENTS.md`, `.github/copilot-instructions.md`
 
@@ -16,9 +16,6 @@ Target files: `CLAUDE.md`, `AGENTS.md`, `.github/copilot-instructions.md`
 1. **Create a parser** in `sync_ai_rules/parsers/`:
 
 ```python
-from sync_ai_rules.core.parser_interface import InputParser
-from sync_ai_rules.core.rule_metadata import RuleMetadata
-
 class YourParser(InputParser):
     @property
     def name(self) -> str:
@@ -34,8 +31,6 @@ class YourParser(InputParser):
 2. **Create a generator** in `sync_ai_rules/generators/`:
 
 ```python
-from sync_ai_rules.generators.base_generator import BaseGenerator
-
 class YourGenerator(BaseGenerator):
     @property
     def name(self) -> str:

sync_ai_rules/file_updater.py

@@ -90,5 +90,5 @@ def update_documentation_file(
 
         return True, f"Successfully {operation} rules section in {file_path}"
 
-    except (FileNotFoundError, PermissionError, UnicodeDecodeError, OSError) as e:
+    except Exception as e:
         return False, f"Failed to update {file_path}: {e}"

sync_ai_rules/plugins.yaml

@@ -1,6 +1,4 @@
 # Plugin configuration for sync_ai_rules
-# Define rule processing pipelines: each pipeline has a parser and generator.
-# Parsers and generators can be reused across multiple pipelines.
 
 pipelines:
   - name: development-rules