docs: fold field feedback into the Polar Alignment guide#518
Open
brickbots wants to merge 1 commit into
Open
Conversation
Users testing the Polar Alignment tool reported the technique that actually works in the field, and the failure mode that most often ruins a session. Fold both into the user guide: - New 'Getting a good measurement' sub-section: per-mount aim/sweep/ roll-fit advice (EQ mount: 7-10 deg off the polar axis, 30-45 deg sweep, Roll Off; platform: within 5 deg of Polaris, Roll On) and realistic accuracy expectations (20-30 arcmin, ~10 with a rigid connection). - Warn at the adjustment stage to lock both mount axes first - a slipping RA clutch was the most common field failure - and on a platform to adjust only the platform. - Add 'turn off sidereal tracking' to the prerequisites. - Replace the 'aim well away from the pole' advice, which field experience contradicted: flexure (mostly in roll) grows with attitude change, so near-pole moderate sweeps beat wide ones. Co-Authored-By: Claude Opus 4.8 (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
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
Early users of the Polar Alignment tool reported back with the technique that actually works in the field, plus the failure mode that most often ruins a session. This PR folds that feedback into the user guide's Polar Alignment section.
Not included (possible follow-up)
The same discussion suggested putting a short version of the lock-your-clutches / tracking-off reminder on the ADJUST screen itself, varying by EQ/Alt-Az mode. That's a code change to
ui/polar_align.py, left out of this docs-only PR.Testing
sphinx-build -b html -n(nitpicky mode) runs clean — no warnings, both new:ref:targets resolve.🤖 Generated with Claude Code