Docs backlog: focus, alignment reticle, catalogs, SkySafari, updates + FAQ consolidation#439
Merged
Conversation
Quick Start (item #2): focus is the most common reason solving fails, so lead the Setting Focus section with that, stress zooming to 2x/4x to judge star tightness, give a ~6mm-of-thread starting position, and add high-thin cloud plus the AUTO-exposure (2.2.x caveat) to the troubleshooting note. Cross-link to the new Troubleshooting page. Catalogs (item #6): add the missing TLK (variable stars) and Lyn (Lyngå open clusters) catalogs, correct the WDS pair count to 130,000+ to match the shipped database, and document finding large catalogs by Name Search or Nearest sorting. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Shift the house-voice guidance from "encouraging and a little excited" toward warm but measured, reserve exclamation points, and add a rule to never open a sentence with a conjunction (And/But/So). Bring the skill's own prose into line with that rule. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Add a note to the Alignment section stating the Telrad-style reticle marks where the scope points within the camera's 10° field of view and will not be centered, which is normal. Re-capture all four alignment demo images on a single consistent star field so the reticle is clearly off-center and the flow reads coherently. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Dim elements like the title bar text were hard to read after the linear amber recolor. Add a --gamma step (default 1.5, >1 brightens) applied to the intensity before recoloring so screenshots stay legible at doc size. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Add a "Using SkySafari" section (follow scope on chart, send targets; the single-connection limit; no GoTo slew or simultaneous GoTo-mount yet; sleep mode stops updates) and a "Troubleshooting" section (PiFinderAP auto-disconnect, .local -> numeric IP, no position until first solve, same-SSID interference) to the otherwise setup-only page. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
In the Update Software section, reassure that updates happen on-device (no mail-in; units often ship a version or two behind) and explain that an "unknown" version means no internet rather than a reason to re-image. In the software setup page, note that a "not a multiple of 512 bytes" write error means a corrupted/partial download. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The user guide carried a separate FAQ (EQ mount, motorized-mount control, GPS/chrony system clock) duplicating the role of the new Troubleshooting & FAQ page. Move those three questions onto troubleshooting.rst in its bold-question style (code blocks preserved) and replace the user-guide FAQ section with a pointer so there is a single FAQ. 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.
Works through several items from the documentation enhancement backlog, plus two supporting tooling improvements.
Documentation
TLK(variable stars) andLyn(Lyngå open clusters) catalogs, correct the WDS pair count to 130,000+ to match the shipped DB, and document finding large catalogs via Name Search / Nearest sorting..local→IP, no position until first solve, same-SSID interference).Tooling (docs skill)
screenshot_to_doc.py— add a--gammamid-tone lift (default 1.5) so dim elements like the title bar stay legible after the amber recolor.Verification
Nitpicky Sphinx build (
sphinx-build -n) is clean aside from the pre-existing_static/api.rstwarnings; all cross-references resolve. The four new alignment images were captured with thepifinder-remoteskill and converted with the updatedscreenshot_to_doc.py.🤖 Generated with Claude Code