Skip to content

docs: polish the README with GitHub Markdown features - #3204

Merged
vishr merged 3 commits into
masterfrom
docs/readme-visual
Oct 30, 2026
Merged

vishr merged 3 commits into
masterfrom
docs/readme-visual

Conversation

@vishr

@vishr vishr commented Oct 30, 2026

Copy link
Copy Markdown
Member

Uses GitHub Markdown features the README did not use yet (docs):

  • Centered header: Echo logo with light and dark variants (<picture>, logos in .github/assets/ from the website), tagline, badges and a link row including Echo Pro and commercial support.
  • About with a Mermaid diagram of the request flow (Pre middleware, router, middleware, handler, HTTPErrorHandler), checked against serveHTTP.
  • Alerts: a NOTE that v4 is in maintenance, an IMPORTANT box for private vulnerability reports.
  • Example output in a console block; e.Start graceful shutdown on Ctrl+C.
  • Third-party middleware list in a collapsed <details> section.

Reviewed by Codex; its one finding (Pre middleware errors in the diagram) is fixed.

vishr added 3 commits October 30, 2026 07:41
Add a centered header with the Echo logo for light and dark themes, the
tagline, badges and a link row including Echo Pro and commercial support.
Rename the intro to About and add a Mermaid diagram of the request flow.
Use alerts for the v4 maintenance note and vulnerability reporting, show the
example's output, and fold the third-party middleware list into a collapsed
section.
pkg.go.dev shows GitHub alerts as literal [!NOTE] text and does not render
Mermaid. Use bold notes and a numbered request-flow list instead, and load
the logos from absolute URLs so they show outside GitHub.
@vishr
vishr merged commit 7af8fac into master Oct 30, 2026
11 checks passed
@vishr
vishr deleted the docs/readme-visual branch October 30, 2026 15:04
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