Add bilingual translation and comprehensive user documentation#6
Open
patofoto wants to merge 8 commits intoFly3DTeam:mainfrom
Open
Add bilingual translation and comprehensive user documentation#6patofoto wants to merge 8 commits intoFly3DTeam:mainfrom
patofoto wants to merge 8 commits intoFly3DTeam:mainfrom
Conversation
- Translated buffer.h: pins, structures, function declarations - Translated buffer.cpp: header, global variables, watchdog init - Fixed DIR_PIN naming conflict (motor vs MDM signal) - Kept Chinese alongside English for reference - Compilation successful with no warnings
- Added warning comments about DIR_PIN being redefined - Reverted code changes to keep developer's original logic - Only translation comments added, no code modifications - Compilation successful with expected warnings
- Complete installation and setup instructions - Runtime configuration guide (serial commands) - Compile-time configuration guide (advanced) - Command reference table - Common use cases with examples - Troubleshooting section - Replaced line numbers with VS Code Find instructions for maintainability - Added dfu-util installation to prerequisites - Large, scannable headers for easy navigation
- Document missing GitHub Releases for existing tags - Provide recommendations for creating releases with notes - Include example release notes structure - Update branch name in footer
- Translated all remaining 59 Chinese-only comments in function implementations - All comments now bilingual (English + Chinese) - No functional code changes, only comment translations - buffer.cpp now fully translated
Avatarsia
pushed a commit
to Avatarsia/BufferPLUS-klipper
that referenced
this pull request
Apr 22, 2026
12 Verbesserungen aus der parallelen LLL_Plus-Variante integriert. Unser Refactor (Helpers, Parametrisierung, Raw-State) bleibt. Kategorie A - Sensor- und Event-Filterung: ss1gohan13#1 Sensor disable waehrend Erstbefuellung, reaktivieren in _initial_follow_end, STOP_BUFFER_FILL, BUFFER_AUTO_ON ss1gohan13#2 runout_gcode ignoriert Events wenn manual_operation==1 Fly3DTeam#3 HALL2/HALL3 Guards erweitert um manual_operation-Check Fly3DTeam#4 HALL1 selektiv: nur _MANUAL_FEED stoppen, LOAD/UNLOAD weiterlaufen lassen. action_respond_info() statt M118 mit Emoji. Guard zusaetzlich. Kategorie B - Toggle-Features: Fly3DTeam#6 variable_feed_burst_enabled (default 0): Triple-Feed-Burst nur aktiv wenn =1. Default = sicher (Dauerlauf-Neustart). Fly3DTeam#8 variable_auto_load_after_follow (default 0): nach Follow-Phase automatisch LOAD_FILAMENT wenn Hotend warm, nur wenn =1. Kategorie C - UNLOAD-Praezision: Fly3DTeam#9 Phase 3a Distanz = load_fast_distance + Follow-Strecke (initial_follow_speed * initial_follow_duration). Fly3DTeam#10 sync_locked=0 und sync_state=0 explizit am UNLOAD-Ende. Kategorie D - Diagnose: Fly3DTeam#11 _STATE_DUMP zeigt sync_locked und sync_state. Fly3DTeam#12 _boot_autostart ueberspringt BUFFER_AUTO_ON wenn initial_lockout==1 (Stromausfall-Edge-Case). Fly3DTeam#13 ENABLE/DISABLE_RUNOUT_SENSOR description nennt runout_pause=1-Abhaengigkeit explizit. Punkt Fly3DTeam#5 (M118 -> action_respond_info flaechig) bewusst uebersprungen - nur HALL1 bekommt das, Rest bleibt M118. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR adds English translations to the codebase and provides comprehensive user documentation to make the firmware more accessible to international users.
Changes
🌐 Translation Work
lib/buffer/buffer.h- Fully translatedlib/buffer/buffer.cpp- Header and global variables translated📚 Documentation
📝 Developer Notes
Benefits
Testing
Notes