Skip to content

README: shorter, with the detail left to the docs and the FAQ - #216

Merged
combwizard merged 1 commit into
mainfrom
readme-shorter
Nov 13, 2026
Merged

combwizard merged 1 commit into
mainfrom
readme-shorter

Conversation

@combwizard

Copy link
Copy Markdown
Owner

The README repeated the docs pages nearly word for word: requirements, install, first steps, updating, uninstalling and building. It goes from about 1,870 words to about 1,050.

What stays in the README:

  • The intro and the trailer.
  • The feature list, now one or two lines an item. Auto slots are in it.
  • The four install steps and the SmartScreen note, since people read them on GitHub right before downloading.
  • What the keyboard hook does, as a short "How it works".
  • The build commands, the licence and the disclaimer.

What it links to instead of repeating:

  • docs/install.md for what the installer changes, the SHA-256 file, updating, the portable zip, uninstalling and the upgrade from Radial Menu for ZBrush.
  • docs/getting-started.md for the first steps in Studio.
  • docs/building.md and CONTRIBUTING.md for the rest of the build and for running from a checkout.
  • The FAQ on the landing page for the short questions.

Also gone: the line that said the needs-testing issues list quick checks for ZBrush 2023 and 2025. The only open issue with that label is #213, which is a measuring task.

The Build from source heading keeps its name because the landing page links to #build-from-source. ring.png and fan-out.gif are no longer in the README; the docs and the landing page still use them.

No changelog line: nothing in the app changes.

Requirements, install, first steps, updating and building repeated the docs
pages nearly word for word. The README keeps the four install steps, the
SmartScreen note and what the keyboard hook does, and links to the docs and
the FAQ for the rest. The feature list is one or two lines an item and now
has auto slots. The line about needs-testing checks for ZBrush 2023 and 2025
is gone: no open issue asks for one.
@combwizard
combwizard enabled auto-merge (squash) November 13, 2026 23:19
@combwizard
combwizard merged commit 96c37bb into main Nov 13, 2026
8 checks passed
@combwizard
combwizard deleted the readme-shorter branch November 13, 2026 23:21
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