Skip to content

fix(seo): optimize titles and descriptions for 50 blog posts (batch 2)#2021

Merged
Baoyuantop merged 6 commits intoapache:masterfrom
moonming:fix/blog-title-description-rewrites-batch2
Apr 13, 2026
Merged

fix(seo): optimize titles and descriptions for 50 blog posts (batch 2)#2021
Baoyuantop merged 6 commits intoapache:masterfrom
moonming:fix/blog-title-description-rewrites-batch2

Conversation

@moonming
Copy link
Copy Markdown
Member

Summary

SEO title and meta description optimization for 50 blog articles ranked 31-80 by SEO impact score. This is the second batch following PR #2020 (batch 1: top 30 articles).

Changes

Rewrites frontmatter title and description fields across 50 blog posts to:

  • Shorten titles to ≤55 characters — prevents truncation in Google SERPs (with | APISIX suffix added by Docusaurus, total stays ≤64 chars)
  • Compress descriptions to ≤155 characters — ensures full display in search snippets
  • Place primary keywords early in titles for better ranking signals
  • Replace vague "this article describes..." phrasing with clear value propositions
  • Align with search intent — action-oriented titles that match what users actually search for

Examples

File Before Title After Title
beeto-with-apache-apisix.md Practice of localized application with API gateway in the Middle East (69c) How Beeto Uses APISIX for API Management (41c)
cve-2022-29266.md The Vulnerability of Leaking Information in Error Response from jwt-auth Plugin(CVE-2022-29266) (88c) CVE-2022-29266: jwt-auth Secret Leak Fix (40c)
why-we-need-apache-apisix.md Why do you need Apache APISIX when you have NGINX and Kong? (59c) Why Choose APISIX Over NGINX and Kong? (39c)
file-logger-api-gateway.md How to develop plugin in API Gateway (36c, keyword-missing) Build an APISIX Plugin: file-logger Tutorial (45c)
apisix-owasp-coraza-core-ruleset.md Hardening Apache APISIX with the OWASP's Coraza and Core Ruleset (63c) Protect APIs with OWASP Coraza WAF in APISIX (46c)

SEO Rules Applied

  1. Titles ≤55 chars with primary keyword in first 30 chars
  2. Descriptions ≤155 chars with clear value proposition
  3. Use "APISIX" (not "Apache APISIX") in titles to save space — brand suffix handles the full name
  4. Search-intent framing over narrative framing
  5. CVE titles include CVE ID + short impact summary

Files Changed

50 blog post markdown files under blog/en/blog/

Related PRs

Rewrite SEO titles (≤55 chars) and meta descriptions (≤155 chars)
for 50 high-impact blog articles ranked 31-80 by SEO impact score.

Changes include:
- Shorten titles to fit SERP display limits
- Add primary keywords early in titles
- Replace vague descriptions with value propositions
- Fix keyword-missing and search-intent alignment issues
- Improve CTR potential with actionable language
Copilot AI review requested due to automatic review settings April 10, 2026 00:56
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the SEO-facing frontmatter (title and description) for 50 English blog posts (SEO impact ranks 31–80) to improve SERP display and keyword relevance, continuing the batch approach from PR #2020.

Changes:

  • Rewrites frontmatter titles to be shorter and more keyword-forward (to avoid Google truncation with the Docusaurus suffix).
  • Rewrites meta descriptions to be more concise and value-focused (to avoid snippet truncation).
  • Standardizes phrasing away from vague “this article…” descriptions toward intent-matching summaries.

Reviewed changes

Copilot reviewed 50 out of 50 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
blog/en/blog/2025/07/29/announcing-integration-of-apisix-and-ai-ml-api.md Title/description shortened; keyword-forward AI/ML integration framing
blog/en/blog/2025/06/18/mcp-monetization-navigating-ai-economy.md Description rewritten for intent/value proposition
blog/en/blog/2025/04/21/host-mcp-server-with-api-gateway.md Title shortened; description corrected to match article topic
blog/en/blog/2025/04/01/embrace-intelligent-api-management-with-ai-and-mcp.md Title/description reframed around natural-language management
blog/en/blog/2025/02/17/cloud-vs-open-source-vs-commercial-api-gateways.md Title shortened (removed question framing)
blog/en/blog/2024/07/11/watermarking-infrastructure.md Title/description condensed; clearer value proposition
blog/en/blog/2024/05/02/cve-2024-32638.md CVE title standardized; description provides upgrade guidance
blog/en/blog/2024/04/11/implement-idempotency-key-apisix.md Title/description tightened; clearer takeaway
blog/en/blog/2024/02/13/apisix-owasp-coraza-core-ruleset.md Title/description reframed around OWASP/Coraza protection intent
blog/en/blog/2024/02/07/unlock-observability-for-apisix-with-deepflow.md Title/description adjusted to emphasize eBPF observability
blog/en/blog/2023/12/19/datavisor-uses-apisix.md Case study title/description made more specific
blog/en/blog/2023/12/14/migu-video-adopts-apisix.md Case study title/description reframed to highlight scale/benefits
blog/en/blog/2023/12/14/apisix-plugins-priority-leaky-abstraction.md Title/description reframed as a practical guide
blog/en/blog/2023/06/30/apisix-mqtt-proxy.md Title/description clarified; more actionable phrasing
blog/en/blog/2023/05/04/apache-apisix-chaos-engineering.md Title/description shortened; clearer “how-to” intent
blog/en/blog/2023/04/14/10-api-management-trends-2023.md Title/description shortened; tighter trend summary
blog/en/blog/2023/03/02/security-policy-auditable.md Description rewritten to emphasize centralized security benefits
blog/en/blog/2023/01/18/consul-with-apisix.md Title/description rewritten to emphasize Consul SD (not KV)
blog/en/blog/2022/12/14/web-caching-server.md Title/description reframed as server-side caching guide
blog/en/blog/2022/12/07/web-caching-client.md Title/description reframed as client-side caching guide
blog/en/blog/2022/09/13/why-is-apache-apisix-the-best-api-gateway.md Description rewritten to be more direct/comparative
blog/en/blog/2022/08/28/fault-injection-testing-with-api-gateway.md Description rewritten to be action-oriented and specific
blog/en/blog/2022/07/30/why-we-need-apache-apisix.md Title/description reframed as comparison-focused query
blog/en/blog/2022/07/06/use-keycloak-with-api-gateway-to-secure-apis.md Title/description shortened; more instructional tone
blog/en/blog/2022/06/14/beeto-with-apache-apisix.md Case study title/description shortened; clearer “how” framing
blog/en/blog/2022/06/07/installation-performance-test-of-apigateway-apisix-on-aws-graviton3.md Title/description reframed around benchmark comparison
blog/en/blog/2022/04/20/cve-2022-29266.md CVE title standardized; description includes fix guidance
blog/en/blog/2022/03/04/apisix-uses-coredns-enable-service-discovery.md Description rewritten to be more direct/config-focused
blog/en/blog/2022/03/01/apisix-integration-public-api-plugin.md Title/description rewritten for “protect internal APIs” intent
blog/en/blog/2022/02/25/consul-api-gateway.md Description rewritten to describe Consul KV integration outcome
blog/en/blog/2022/02/23/csrf-api-gateway.md Description rewritten to be more action-oriented
blog/en/blog/2022/02/16/file-logger-api-gateway.md Title/description reframed as a hands-on plugin tutorial
blog/en/blog/2022/02/11/cve-2022-24112.md CVE title standardized; description includes upgrade guidance
blog/en/blog/2021/12/17/exposure-istio-with-apisix-ingress.md Title/description shortened; clearer integration framing
blog/en/blog/2021/12/15/deploy-apisix-in-kubernetes.md Description rewritten as a Helm-based step-by-step guide
blog/en/blog/2021/12/08/apisix-integrate-rocketmq-logger-plugin.md Description rewritten to be more specific/actionable
blog/en/blog/2021/12/07/apisix-integrate-skywalking-plugin.md Title/description rewritten as a “plugins guide”
blog/en/blog/2021/11/30/use-apisix-ingress-in-kubesphere.md Title/description reframed for KubeSphere monitoring intent
blog/en/blog/2021/11/12/apisix-datadog.md Description rewritten as integration/how-to summary
blog/en/blog/2021/11/04/skywalking.md Title/description reframed for observability intent
blog/en/blog/2021/09/14/youzan.md Title/description reframed; fixes APISIX naming in title
blog/en/blog/2021/09/07/how-to-use-apisix-auth.md Title/description shortened; clearer auth plugin coverage
blog/en/blog/2021/08/18/Auth-with-Casbin-in-Apache-APISIX.md Title/description reframed around RBAC outcome
blog/en/blog/2021/08/10/apisix-nginx.md Title/description reframed to focus on dynamic management
blog/en/blog/2021/07/27/use-of-plugin-orchestration-in-Apache-APISIX.md Title/description reframed as a low-code guide
blog/en/blog/2021/07/14/the-road-to-customization-of-Sina-Weibo-API-gateway-based-on-Apache-APISIX.md Title/description reframed as an NGINX→APISIX migration story
blog/en/blog/2021/03/02/get-front-end-test-coverage-with-cypress.md Title/description reframed for E2E coverage/measurement intent
blog/en/blog/2021/02/08/stable-product-delivery-with-cypress.md Description rewritten to focus on Cypress E2E value
blog/en/blog/2021/01/11/interview-Apache-APISIX-contributor-Wang-Pengcheng-Senior-Security-Advisor-of-PwC-South-China-Data-Security-and-Privacy-Protection-Team.md Title/description rewritten to include CVE framing
blog/en/blog/2020/12/16/another-way-to-implement-envoy-filter.md Title/description reframed around running APISIX plugins in Envoy

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Yilialinn and others added 3 commits April 12, 2026 20:52
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
…o-API-gateway-based-on-Apache-APISIX.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 50 out of 50 changed files in this pull request and generated 2 comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

- Envoy
- Envoy filter
description: This article describes extending Envoy with new functionality and concrete examples using the base library of the cloud-native API gateway Apache APISIX.
description: Run APISIX Lua plugins as Envoy filters using apisix-seed. Extend Envoy with dynamic capabilities without writing C++ code.
Copy link

Copilot AI Apr 12, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Frontmatter description references "apisix-seed", but the post body links to and discusses the api7/envoy-apisix repo and doesn’t mention apisix-seed elsewhere. This makes the description misleading; align it with the actual project name used in the article.

Suggested change
description: Run APISIX Lua plugins as Envoy filters using apisix-seed. Extend Envoy with dynamic capabilities without writing C++ code.
description: Run APISIX Lua plugins as Envoy filters using envoy-apisix. Extend Envoy with dynamic capabilities without writing C++ code.

Copilot uses AI. Check for mistakes.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed @Baoyuantop

Yilialinn and others added 2 commits April 13, 2026 11:46
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@Baoyuantop Baoyuantop merged commit f02644b into apache:master Apr 13, 2026
3 checks passed
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.

4 participants