Skip to content

README: lead with the project name, move upgrade notes to UPGRADING.md - #642

Merged
compscidr merged 2 commits into
mainfrom
docs/readme-seo
Oct 3, 2026
Merged

compscidr merged 2 commits into
mainfrom
docs/readme-seo

Conversation

@compscidr

@compscidr compscidr commented Oct 3, 2026 •

Copy link
Copy Markdown
Collaborator

Why

Searching Bing for "goblog" shows this repo with the 0.7.0 plugin upgrade note as its snippet instead of a description. That paragraph was the most "goblog"-dense passage on the page, while the README's opening line never mentioned the project name.

What

  • README now opens with a sentence that names and describes GoBlog (heading changed from goblog to GoBlog).
  • The three upgrade notes (0.7.0 themes, 0.7.0 plugins, 0.3.0 scholar) move verbatim into a new UPGRADING.md, linked from the top of the README. Their #installing-from-the-directory links now point back at the README.
  • Build and codecov badges point at goblogplatform/goblog instead of compscidr/goblog (both new URLs return 200).
  • README links the official site (https://www.goblog.live) in the opening line and gains a "Sites running GoBlog" section inviting PRs to add your own site.

Not changed: the compscidr/goblog Docker image name and the in-container /go/src/github.com/compscidr/goblog paths, which are still what the Dockerfile and release workflows use.

Docs only; no code changes.

🤖 Generated with Claude Code

Search engines were using the 0.7.0 plugin upgrade note as the repo's
snippet because it was the most name-dense passage on the page. Open
the README with a sentence that names and describes GoBlog, move the
per-release upgrade notes into UPGRADING.md, and point the build and
coverage badges at goblogplatform/goblog instead of the old org.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Copilot AI balanced review requested due to automatic review settings October 3, 2026 06:13

Copilot AI 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.

Copilot review overview

🟢 Approval recommended

It is a docs-only change whose moved content, cross-file anchors, badge URLs, and absence of dangling references were all verified as correct.

Review effort: Balanced
Findings: None

What changed in this PR

This is a documentation-only PR aimed at improving the repository's search-engine snippet and discoverability. It rewrites the README's opening so the project name ("GoBlog") and a descriptive sentence lead the page, extracts the release-specific upgrade notes into a dedicated UPGRADING.md, and repoints the build/codecov badges from compscidr/goblog to the new goblogplatform/goblog location.

Changes:

  • README now opens with # GoBlog and a descriptive sentence, plus a link to the new UPGRADING.md.
  • The three upgrade notes (0.7.0 themes, 0.7.0 plugins, 0.3.0 scholar) move verbatim into UPGRADING.md, with their directory links rewritten as cross-file README.md#installing-from-the-directory anchors.
  • Build and codecov badge URLs switch to goblogplatform/goblog.
File Description
README.md Renames heading to GoBlog, adds a descriptive lead line and an UPGRADING.md link, updates badge URLs, and removes the inline upgrade notes.
UPGRADING.md New file collecting the 0.7.0 and 0.3.0 upgrade notes (newest first), with directory links pointing back to the README anchor.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@compscidr
compscidr merged commit cb50950 into main Oct 3, 2026
1 check passed
@compscidr
compscidr deleted the docs/readme-seo branch October 3, 2026 06:25
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.

2 participants