Improve docs

Author: justin808

CHANGELOG.md

@@ -27,10 +27,10 @@ Changes since the last non-beta release.
 
 #### Removed (Breaking Changes)
 
-- **Webpacker support completely removed**. Shakapacker 8.2+ is now required.
+- **Webpacker support completely removed**. Shakapacker >= 6.0 is now required.
   - Migration:
     - Remove any `webpacker` gem references from your Gemfile
-    - Ensure `shakapacker` gem version 8.2.0 or higher is installed
+    - Ensure `shakapacker` gem version 6.0 or higher is installed (8.0+ recommended)
     - Replace any `bin/webpacker` commands with `bin/shakapacker`
     - Update any webpacker configuration files to shakapacker equivalents
   - Removed files: `rakelib/webpacker_examples.rake`, `lib/generators/react_on_rails/adapt_for_older_shakapacker_generator.rb`

CONTRIBUTING.md

@@ -248,7 +248,7 @@ gem 'react_on_rails', path: '../relative/path/to/react_on_rails'
 
 Then run `bundle`.
 
-The main installer can be run with `rails generate react_on_rails:install`
+The main installer can be run with `./bin/rails generate react_on_rails:install`
 
 Then use yalc to add the npm module.
 
@@ -277,11 +277,19 @@ For comprehensive testing of generator changes, use this manual testing workflow
 **1. Set up test application with clean baseline:**
 
 ```bash
-# Navigate to test app directory (replace with your test app)
-cd ~/shakacode/react-on-rails/react_on_rails-test-apps/react-on-rails-tutorial-v15
+# Create a test Rails app
+mkdir -p {project_dir}/test-app
+cd {project_dir}/test-app
+rails new . --skip-javascript
+
+# Set up for testing the generator
+echo 'gem "react_on_rails", path: "../react_on_rails"' >> Gemfile
+yalc add react-on-rails
 
 # Create a clean baseline tag for testing
+git init && git add . && git commit -m "Initial commit"
 git tag generator_testing_base
+bundle install
 
 # Clean reset to baseline state
 git clean -fd && git reset --hard && git clean -fd
@@ -302,7 +310,7 @@ git clean -fd && git reset --hard generator_testing_base && git clean -fd
 bundle install
 
 # Run generator - should install Shakapacker automatically
-rails generate react_on_rails:install
+./bin/rails generate react_on_rails:install
 
 # Verify Shakapacker was added to Gemfile and installed correctly
 ```
@@ -313,18 +321,17 @@ rails generate react_on_rails:install
 # Reset to clean baseline
 git clean -fd && git reset --hard generator_testing_base && git clean -fd
 
-# Ensure Shakapacker is in Gemfile
-echo 'gem "shakapacker", "~> 8.0"' >> Gemfile
-bundle install
+# Add Shakapacker to Gemfile
+bundle add shakapacker --strict
 
 # Run Shakapacker installer first
-bundle exec rails shakapacker:install
+./bin/rails shakapacker:install
 
 # Edit Gemfile to update gem path: gem 'react_on_rails', path: '../path/to/main/repo'
 bundle install
 
 # Run generator - should detect existing Shakapacker
-rails generate react_on_rails:install
+./bin/rails generate react_on_rails:install
 
 # Verify generator adapts to existing Shakapacker setup
 ```
@@ -342,44 +349,6 @@ For each commit tested, document:
 
 This systematic approach ensures generator changes work correctly whether Shakapacker is pre-installed or needs to be installed by the generator.
 
-#### Testing Specific Generator Commits
-
-When testing specific commits that fix generator issues, follow this process:
-
-**Example: Testing commits 81c66fa and bc69dcd0**
-
-1. **Commit 81c66fa**: "Now automatically creates packs" - Test pack generation functionality
-2. **Commit bc69dcd0**: "Fix React on Rails v15 generator and restore colorized output" - Test generator fixes and output formatting
-
-**Testing workflow for each commit:**
-
-```bash
-# In main react_on_rails repository
-cd ~/shakacode/react-on-rails/react_on_rails
-git checkout <commit-hash>  # e.g., 81c66fa or bc69dcd0
-
-# In test application
-cd ~/shakacode/react-on-rails/react_on_rails-test-apps/react-on-rails-tutorial-v15
-
-# Reset to clean baseline
-git clean -fd && git reset --hard generator_testing_base && git clean -fd
-
-# Update Gemfile to point to current commit
-# Edit: gem 'react_on_rails', path: '../../../react_on_rails'
-bundle install
-
-# Test both Shakapacker scenarios (A and B above)
-# Document results for this specific commit
-```
-
-**Expected outcomes to verify:**
-
-- Generator completes without errors
-- Shakapacker integration works correctly
-- React components render and are interactive
-- Development server starts successfully with `bin/dev`
-- Console output shows expected messages and minimal warnings
-
 #### Testing Generator with Yalc for React Component Functionality
 
 When testing the install generator with new Rails apps, you need to use **yalc** for the JavaScript package to ensure React components work correctly. The Ruby gem path reference is insufficient for client-side rendering.
@@ -523,14 +492,8 @@ rake lint
 ### 1. **After Making Code Changes**
 
 ```bash
-# MANDATORY: Run linters after code changes
-rake lint
-
-# If any violations, auto-fix immediately
-rake autofix  # One command to run all auto-fixes
-
-# Verify everything passes
-rake lint
+# Auto-fix all linting violations after code changes
+rake autofix
 ```
 
 ### 2. **Common AI Agent Mistakes**