moonming opened a new pull request, #13222: URL: https://github.com/apache/apisix/pull/13222
## Summary SEO improvements to documentation: human-readable plugin page titles and expanded Getting Started guide. ### Plugin Title Optimization (85 files) Changed frontmatter `title` from code identifiers to human-readable names. Only the `title` field was modified — no other content was changed. **Format**: `Human-Readable Name (code-identifier)` | Before | After | |--------|-------| | `limit-req` | `Rate Limiting (limit-req)` | | `limit-count` | `Rate Limiting by Count (limit-count)` | | `openid-connect` | `OpenID Connect (openid-connect)` | | `grpc-transcode` | `gRPC Transcoding (grpc-transcode)` | | `ip-restriction` | `IP Restriction (ip-restriction)` | | `proxy-cache` | `Proxy Cache (proxy-cache)` | | `http-logger` | `HTTP Logger (http-logger)` | | `api-breaker` | `API Circuit Breaker (api-breaker)` | **Why**: Plugin pages are high-value SEO targets for long-tail queries like "API gateway rate limiting plugin". The current code-only titles (e.g., `limit-req`) don't match what developers search for. Kong's equivalent pages use descriptive titles like "Rate Limiting" and rank significantly higher. ### Getting Started Expansion Expanded from ~300 words to ~800 words: - **Title**: "Get APISIX" → "Getting Started with Apache APISIX" - **Added**: Alternative installation methods table (Docker Compose, Helm, RPM, source) - **Added**: Complete first route configuration example with httpbin.org - **Added**: Plugin usage example (limit-count with test script) - **Added**: Dashboard access instructions - **Added**: Troubleshooting section (port conflicts, etcd errors, auth issues) - **Improved**: Description meta tag for search engines ## Test plan - [ ] Documentation builds successfully (`make build-doc` or equivalent) - [ ] Plugin page titles render correctly in sidebar and browser tabs - [ ] Getting Started page content is complete and examples work - [ ] No broken links in Getting Started page -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
