Skip to content

Say "Wortuhr" where somebody searching for one can read it - #73

Merged
AndreasBur merged 1 commit into
masterfrom
readme-findable-in-search
Aug 25, 2026
Merged

Say "Wortuhr" where somebody searching for one can read it#73
AndreasBur merged 1 commit into
masterfrom
readme-findable-in-search

Conversation

@theAndreas

Copy link
Copy Markdown
Collaborator

The repository is public since 2017 and does not appear in a search for its own author's
name plus "Wordclock" — only the profile page does. Five things are missing; three of them
are files and are in here.

Vocabulary. Nearly all search demand in this niche is German — Wortuhr, Wortuhr
ESP32
, Wortuhr Selbstbau — and that word appeared nowhere in the repository but
docs/roadmap.md, so the page could not rank for the term its own subject is called by.
The <h1>, the opening paragraph and a short German summary now carry it, together with
the hardware words a builder actually types: WS2812, ESP32-S3, Pico 2 W, NTP, over the air.
The title and the first paragraph are what a search engine shows as the result, so that is
where they had to go rather than into a section further down.

The cold arrival. A stranger landing on the README was sent straight into a table of
directories, which answers a question they had not asked yet. ## What it does comes first
now and says what can be built.

A repository page ranks weakly on its own, so docs/ is made ready to be the project
site: a landing page plus the Jekyll config for jekyll-theme-primer. That theme is the one
GitHub hosts itself — a remote_theme would need a Gemfile and a build step, and nothing
here wants a Ruby toolchain in the repository. No workflow is added for the same reason:
GitHub builds a /docs source by itself.

Nothing new claims a size, so tools/documented-sizes.py has nothing more to check — it
still passes with web/README.md as its only subject.

What this PR cannot do

Two of the five are admin-only fields on the repository and one is off-site, so they stay
with the owner account:

  • Topics are empty (topics: []). github.com/topics/wortuhr is a crawled page and the
    main discovery path inside GitHub; without topics the project is not on it. Suggested set:
    wortuhr, wordclock, word-clock, esp32, esp32-s3, rp2350, avr, arduino, ws2812, neopixel, led-matrix, ntp, ota, platformio, cpp17, simulator, wxwidgets, diy, clock, embedded.
  • The description is four words — "Wordclock based on Arduino". It is the Google snippet
    and part of the page title, and it has 350 characters available.
  • Nothing links here. 0 forks, 2 stars, no mention anywhere; that is the factor Google
    weighs most, and no commit reaches it.

Then Settings → Pages → Source: master /docs, and homepage to the URL it produces.

The repository is public since 2017 and does not appear in a search for its
own author's name plus "Wordclock" - only the profile page does. Three of the
five reasons are on this side of the fence.

The first is vocabulary. Nearly all search demand in this niche is German -
"Wortuhr", "Wortuhr ESP32", "Wortuhr Selbstbau" - and that word appeared
nowhere but docs/roadmap.md, so the page could not rank for the term its own
subject is called by. The title, the opening paragraph and a short German
summary now carry it, along with the hardware words a builder searches with:
WS2812, ESP32-S3, Pico 2 W, NTP, over the air.

The second is that a stranger arriving cold was sent straight into a table of
directories. What it does now comes first and says what can be built, which is
the question that brought them.

The third is that a repository page ranks weakly on its own, so docs/ is made
ready to serve as the project site: a landing page and the Jekyll config for
GitHub's own hosted theme, which needs no Gemfile and no build step here. The
switch itself is Settings -> Pages, and that needs admin on the repository -
this account has push only.

The two remaining reasons need no commit and cannot be reached from here: the
repository has no topics and a four-word description, both admin-only fields,
and nothing anywhere links to it.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@AndreasBur
AndreasBur merged commit 330e138 into master Aug 25, 2026
8 checks passed
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.

3 participants