Skip to content

docs(readme): add a first run, the nav line and the banner credit - #28

Merged
EquityBot merged 1 commit into
mainfrom
ryan/readme-best-2026-11-02
Nov 2, 2026
Merged

EquityBot merged 1 commit into
mainfrom
ryan/readme-best-2026-11-02

Conversation

@EquityBot

Copy link
Copy Markdown
Owner

README additions for a first-time reader.

  • First run: the README started at ghostsoap init with no install step. The new section gives the clone and cargo install steps, then ghostsoap plan --pack start-here, which needs no profile and sends nothing, with the start of its output. Checked against a release build of main (ea465d8): the sample matches the first entry exactly. Originally written on 31 October as 713e107 and held until the history rewrite.
  • The brand navigation line under the badges.
  • A banner credit (Cascadia Mono and Besley, SIL OFL 1.1), which the README lacked.
  • '2 years' as a numeral, as in the other EquityBot READMEs.

No code changes.

Add a First run section with clone and install steps and the expected
start of `ghostsoap plan --pack start-here` (checked against a release
build of main), so readers no longer start at `ghostsoap init` with no
install step. Add the brand navigation line, credit the banner fonts
(Cascadia Mono and Besley) and write '2 years' as a numeral.
@EquityBot
EquityBot enabled auto-merge (squash) November 2, 2026 01:04
@sonarqubecloud

sonarqubecloud Bot commented Nov 2, 2026

Copy link
Copy Markdown

@codacy-production

Copy link
Copy Markdown

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

AI Reviewer: first review requested successfully. AI can make mistakes. Always validate suggestions.

Run reviewer

TIP This summary will be updated as you push new changes.

@codacy-production codacy-production Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

✅ No blocking issues noticed

No blocking findings were identified. The documented first-run flow, navigation links, and sample output still lack automated validation coverage.

Test suggestions

  • Validate that the first-run commands work from a fresh clone and that planning requires no profile or network transmission.
  • Verify that each navigation link resolves to an existing README heading.
  • Verify that the documented sample output matches the first entry produced by the command.
Prompt proposal for missing tests
Consider implementing these tests if applicable:
1. Validate that the first-run commands work from a fresh clone and that planning requires no profile or network transmission.
2. Verify that each navigation link resolves to an existing README heading.
3. Verify that the documented sample output matches the first entry produced by the command.

TIP Improve review quality by adding custom instructions
TIP How was this review? Give us feedback

@EquityBot
EquityBot merged commit 602fbbe into main Nov 2, 2026
15 checks passed
@EquityBot
EquityBot deleted the ryan/readme-best-2026-11-02 branch November 2, 2026 01:15
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