Say "Wortuhr" where somebody searching for one can read it - #73
Merged
Conversation
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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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 withthe 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 doescomes firstnow and says what can be built.
A repository page ranks weakly on its own, so
docs/is made ready to be the projectsite: a landing page plus the Jekyll config for
jekyll-theme-primer. That theme is the oneGitHub hosts itself — a
remote_themewould need a Gemfile and a build step, and nothinghere wants a Ruby toolchain in the repository. No workflow is added for the same reason:
GitHub builds a
/docssource by itself.Nothing new claims a size, so
tools/documented-sizes.pyhas nothing more to check — itstill passes with
web/README.mdas 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: []).github.com/topics/wortuhris a crawled page and themain 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.and part of the page title, and it has 350 characters available.
weighs most, and no commit reaches it.
Then
Settings → Pages → Source: master /docs, andhomepageto the URL it produces.