Skip to content

docs: link the README to the website, and print the command the front page promised - #184

Merged
donislawdev merged 2 commits into
masterfrom
seo/indexing-recovery
Sep 7, 2026
Merged

docs: link the README to the website, and print the command the front page promised#184
donislawdev merged 2 commits into
masterfrom
seo/indexing-recovery

Conversation

@donislawdev

Copy link
Copy Markdown
Owner

Search Console reports 16 of the site's 30 addresses indexed. The other 14 sit in
two buckets that need different remedies: 8 are "Discovered - currently not
indexed" (never fetched at all) and 6 are "Crawled - currently not indexed"
(fetched and declined).

URL inspection of the front page rules the technical layer out: Crawl allowed: Yes, Page fetch: Successful, Indexing allowed: Yes, and Google-selected canonical: Inspected URL, so Google did not pick some other page as the
canonical. The decisive field is Referring page, which names exactly one, and
it is the site's own Polish front page. The repository's website field is served
with rel="nofollow", so it passes nothing.

What is here

The README links to the website. Two links, both placed where a reader
benefits rather than for a crawler alone: one under the badges, and one after the
quick start for anyone who wants a walkthrough of a single task instead of the
full manual.

The front page prints the command it promised, in both languages. It said one
command is enough to check that a service survives 10 percent packet loss and
then showed none, while all fourteen other pages show one. This one is a gap in
the page rather than an indexing fix.

What was deliberately left out

Lengthening the six pages in the "Crawled - currently not indexed" bucket, which
was the original plan. The site's own data does not support it. Median words in
<main>: indexed 411 (n=16), crawled and declined 426 (n=6), never crawled 407
(n=8), so the declined pages are longer than the indexed ones. The clearest
counterexamples: one Polish guide is indexed at 335 words, another is declined at
649, and the longest page on the site at 787 words was never crawled at all.

Checks

  • tests/test_site.py: 49 passed
  • README and convention guards: 39 passed
  • ruff and mypy: clean
  • tools/check_public_text.py over both commits: clean
  • The command added to the front page was verified by running it, not by reading
    the parser: --simulate --loss 10 --target myapp.exe --duration 3 exits 0 with
    reason=duration and drops 174 of 1851 packets.

The full suite runs here on CI rather than locally, on both runners.

🤖 Generated with Claude Code

donislawdev and others added 2 commits September 7, 2026 12:31
Search Console reports 16 of the site's 30 addresses indexed. URL inspection of
the home page names exactly one referring page, the site's own Polish home page,
so Google knows of no external link to the site. The repository's website field
is served with rel="nofollow" and passes nothing.

Two links, both placed where a reader benefits rather than for the crawler
alone: one under the badges, and one after the quick start for readers who want
a walkthrough of a single task instead of the full manual.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Both front pages said one command is enough to check that a service survives 10
percent packet loss, and then printed no command. Every other page on the site
prints one, so the entry point was the only page that asked the reader to take
the claim on trust.

Verified by running it, not by reading the parser: --simulate --loss 10 --target
myapp.exe --duration 3 exits 0 with reason=duration and drops 174 of 1851
packets, which is what the new sentence about the run stopping itself claims.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@donislawdev
donislawdev merged commit 0c7b6c1 into master Sep 7, 2026
14 checks passed
@donislawdev
donislawdev deleted the seo/indexing-recovery branch September 7, 2026 11:12
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