Skip to content

Commit 3750762

Browse files
justin808claude
andcommitted
Document console output differences across development modes
Add clear guidance about expected console warnings in different dev modes: - `bin/dev` (HMR): Shows HMR + resource preload warnings (normal) - `bin/dev static`: Shows only resource preload warnings (cleaner) - `bin/dev prod`: Cleanest output, minimal warnings (production-like) Explains that resource preload warnings are normal in development due to Shakapacker's preload tag generation with async script loading. This helps contributors understand which warnings to ignore vs. investigate. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 171b9e8 commit 3750762

File tree

1 file changed

+7
-1
lines changed

1 file changed

+7
-1
lines changed

CONTRIBUTING.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -304,7 +304,13 @@ bin/dev
304304
- Visit the hello_world page in browser
305305
- Check browser console for "RENDERED HelloWorld to dom node" success message
306306
- Confirm React component is interactive (input field updates name display)
307-
- Use `bin/dev static` mode for cleanest console output during testing
307+
308+
**Development Mode Console Output**:
309+
- `bin/dev` (HMR): Shows HMR warnings and resource preload warnings (expected)
310+
- `bin/dev static`: Shows only resource preload warnings (cleaner output)
311+
- `bin/dev prod`: Cleanest output with minimal warnings (production-like environment)
312+
313+
**Note**: Resource preload warnings in development modes are normal and can be ignored. They occur because Shakapacker generates preload tags but scripts load asynchronously. Production mode eliminates most of these warnings.
308314

309315
### Linting
310316

0 commit comments

Comments
 (0)