Skip to content

Trim README to essentials now that the underlying issues are fixed - #13

Merged
AlexWindels merged 1 commit into
mainfrom
docs/trim-readme-to-essentials
Aug 11, 2026
Merged

Trim README to essentials now that the underlying issues are fixed#13
AlexWindels merged 1 commit into
mainfrom
docs/trim-readme-to-essentials

Conversation

@AlexWindels

Copy link
Copy Markdown
Collaborator

Summary

The Installation and Domain-name curation sections had accumulated a lot of live-debugging narrative written while tracking down real issues across several releases (#3-#12): step-by-step Rosetta/terminal diagnostics, uv cache-clearing commands, OpenMP/CMake technical explanations, "if this hangs/fails" caveats. Now that those are actually fixed -- FastTree auto-provisions itself, veryfasttree is correctly platform-gated, Gemini curation has a bounded timeout and automatic fallback -- that's no longer something a new user needs to read; it's history, not instructions.

  • Cut Installation down to what's actually necessary, with a clear, short Windows vs. macOS split
  • Cut Domain-name curation back to the manual/Gemini setup steps, dropping the troubleshooting caveats
  • Added an explicit --curation-backend gemini command-line example (previously only implied through prose)
  • Left Output/Acknowledgements/Citation/Legal sections untouched -- they weren't part of the bloat

Net: 199 -> 131 lines.

Test plan

  • pytest -- 142 passed (README-only change, no code touched)
  • Reviewer: eyeball the rendered README for anything that reads oddly out of context

The Installation and Domain-name curation sections had accumulated a
lot of live-debugging narrative (step-by-step Rosetta/terminal
diagnostics, uv cache-clearing commands, OpenMP/CMake technical
explanations, "if this hangs/fails" caveats) written while tracking
down real issues over several releases (#3-#12). Now that those are
actually fixed -- FastTree auto-provisions itself, veryfasttree is
correctly platform-gated, Gemini curation has a bounded timeout and
automatic fallback -- that troubleshooting detail is no longer
something a new user needs to read to get started; it's history, not
instructions.

Cut it down to what's actually necessary to install and use CANDy,
with a clear, short Windows vs. macOS distinction, and add an explicit
--curation-backend gemini command-line example.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@AlexWindels
AlexWindels merged commit 66e4b75 into main Aug 11, 2026
6 checks passed
@AlexWindels
AlexWindels deleted the docs/trim-readme-to-essentials branch August 11, 2026 08:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant