docs: describe Home as it is now, not as it was - #661
Merged
Conversation
Home was reworked into two columns (#653) and its About section reworked again (#655), but the manual still described the old single-flow page. HOME.md said "Below Needs Attention, you'll see a list of tablets" — Needs attention is the right-hand column now, and the tablet list is on the left under About, so nothing is below anything. It also called the tablet rows "cards", which they stopped being when Entity was de-boxed: they are hairline-separated rows with no container. Adds the About section, which the page never documented at all. USERMANUAL.md's per-page line promised "the About/Help cards". The Help card is gone — its text moved to HELP.md and the card became a "Get help" link — and About is a section with links rather than a card. HELP.md told people to find their version "in parentheses next to ABOUT", which was true for about a day. It is plain text at the end of the About paragraph now, so the instruction points there instead of naming a version-shaped string that will drift. Co-Authored-By: Claude Opus 5 <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.
The manual still described a Home page that no longer exists. Home was reworked into two columns in #653 and its About section reworked again in #655; the docs followed neither.
HOME.mdSaid "Below 'Needs Attention,' you'll see a list of tablets". Needs attention is the right-hand column now, and the tablet list is on the left under About — nothing is below anything.
It also called the tablet rows cards, which they stopped being when
Entitywas de-boxed: they are hairline-separated rows with no container.Adds a sentence for the About section, which the page had never documented at all.
The existing voice and structure are kept; only what had become false is changed.
USERMANUAL.mdIts per-page guide promised "the About/Help cards". The Help card is gone entirely — its text became
HELP.mdand the card became a Get help link — and About is a section, not a card.HELP.mdTold people to find their version "in parentheses next to ABOUT", which was true for about a day before the version moved into the paragraph as plain text. It now points at the end of the About paragraph rather than naming a version-shaped string that will drift again.
For the reviewer
I checked the rest of the docs for the same rot.
ADVANCED.md,INSTALL.mdandSETTINGS.mdreference Needs attention as a concept, which is still accurate;TABLET.mdnever mentionedBASICS, so theMODEL/ACTIVE AREArename left nothing stale there.Layout claims are taken from the current
DashboardView.axamlandAboutView.axaml, not from a screenshot. All relative links in the rewrittenHOME.mdresolve.Docs only — nothing here builds or is covered by tests.