docs(website): drop references to nonexistent micro/blog repo - #4869
Conversation
The "your microservices are already an AI platform" post and the micro-run guide pointed at github.com/micro/blog as a real example repo, but it does not exist — the links 404 and `micro run github.com/micro/blog` would fail. Reword to describe the illustrative blogging platform without claiming a backing repo, point the runnable example at the in-repo examples/mcp/platform, and use placeholder names in the compose/run snippets.
There was a problem hiding this comment.
Pull request overview
Removes broken references to the non-existent github.com/micro/blog repository from the Go Micro website docs/blog content under internal/website/, replacing them with generic language and placeholders while keeping the runnable in-repo example (examples/mcp/platform/) as the suggested reference point.
Changes:
- Retitles and rewrites the
micro runguide example to avoid the deadmicro/bloglink/command and show local/placeholder repo usage. - Rewords the “Your Microservices Are Already an AI Platform” post to remove
micro/bloglink references and replace the docker image example with a placeholder.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| internal/website/content/en/docs/guides/micro-run.md | Replaces the “micro/blog” example section with a generic multi-service example and placeholder run commands. |
| internal/website/content/en/blog/news/your-microservices-are-already-an-ai-platform/index.md | Removes micro/blog references/links and swaps docker image example to a placeholder. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| ## Example: a multi-service app | ||
|
|
||
| The [micro/blog](https://github.com/micro/blog) project demonstrates a multi-service setup: | ||
| A multi-service app is described with a `micro.mu` file: |
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 30f48be648
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| ```bash | ||
| micro run github.com/micro/blog | ||
| micro run . # current directory | ||
| micro run github.com/myorg/blog # remote repo |
There was a problem hiding this comment.
When a reader follows the advertised “straight from a repo” path, micro run treats this argument as a GitHub URL and attempts to clone https://github.com/myorg/blog, but the commit itself identifies myorg/blog as a placeholder rather than an existing example. The command therefore recreates the same dead-command problem this change is intended to fix; use a real repository or clearly present replaceable syntax instead of listing the placeholder as a runnable command.
Useful? React with 👍 / 👎.
Problem
Two pages referenced
github.com/micro/blogas a real example repository, but it doesn't exist — the links 404, and the guide'smicro run github.com/micro/blogcommand would fail:content/en/blog/news/your-microservices-are-already-an-ai-platform/index.md— six mentions (description, prose links, a compose image, closing line)content/en/docs/guides/micro-run.md— an "Example: micro/blog" section with a dead link and run commandFix
examples/mcp/platform/— already lives in this repo and is unchanged.micro run ./micro run github.com/myorg/blog(placeholder) instead.myorg/blogas the placeholder image in the docker-compose snippet.No functional content changed — this is purely removing broken references.
🤖 Generated with Claude Code
Generated by Claude Code