Skip to content

fix(seo): rewrite titles and descriptions for 30 high-value blog posts#2020

Merged
Yilialinn merged 1 commit intoapache:masterfrom
moonming:fix/blog-title-description-rewrites
Apr 12, 2026
Merged

fix(seo): rewrite titles and descriptions for 30 high-value blog posts#2020
Yilialinn merged 1 commit intoapache:masterfrom
moonming:fix/blog-title-description-rewrites

Conversation

@moonming
Copy link
Copy Markdown
Member

Summary

  • Rewrites title and description frontmatter for the 30 highest-impact blog posts based on SEO audit scoring
  • All titles shortened to ≤55 characters (previously 58-89 chars), fitting within Google SERP display limits
  • All descriptions optimized to ≤155 characters with clear value propositions and primary keywords

Why

From the SEO audit of all 320 English blog posts:

  • 82 articles had titles >55 chars (truncated in Google search results)
  • 107 articles had descriptions >155 chars (truncated by Google)
  • 27 articles had titles missing primary keywords
  • 81 articles had descriptions lacking value propositions

This PR addresses the top 30 articles by potential SEO impact — these are evergreen, high-search-volume topics.

What changed

# Article Title change Description change
1 ARM server benchmark 64→48 chars 162→148 chars
2 OpenWhisk plugin 58→47 chars, removed "Coming soon!" Rewritten with clear value
3 AI/ML load balancing No change 200→136 chars
4 Dashboard + Keycloak 71→44 chars 166→139 chars
5 Keycloak auth 57→48 chars Rewritten for clarity
6 HashiCorp Vault 65→47 chars Rewritten with specifics
7 API security pt 1 67→51 chars 447→135 chars
8 API security pt 2 67→51 chars 447→130 chars
9 Nginx observability 59→39 chars, fixed "APISX" typo 180→127 chars
10 Ory Hydra No title change Rewritten with specifics
11 Kafka proxy No title change 193→131 chars
12 Dapr integration 68→45 chars Rewritten for Kubernetes context
13 open-appsec WAF 64→45 chars 165→146 chars
14 Ingress Controller 63→48 chars Rewritten with comparison angle
15 Okta OpenID Connect 81→53 chars Fixed "OKat" typo
16 Centralized auth OIDC 76→53 chars Fixed "OKat" typo, rewritten
17 Java plugin No title change 185→117 chars
18 OpenTelemetry 89→48 chars Rewritten for clarity
19 Splunk HEC 56→44 chars Rewritten with plugin name
20 API monetization 63→44 chars 238→123 chars
21 Kafka logging 56→46 chars Rewritten, fixed typo "Wiht"
22 Zhengcaiyun case study 86→55 chars 199→141 chars, removed author bio
23 APISIX vs Envoy 58→49 chars Rewritten with benchmark framing
24 mTLS config 15→31 chars, added "APISIX" keyword 243→141 chars
25 CVE-2021-33190 78→46 chars 172→136 chars
26 ClickHouse logging No title change 162→139 chars
27 Geo-routing No title change 358→140 chars
28 Rust WebAssembly 59→45 chars Expanded from 95→140 chars
29 Google Cloud T2A 39→52 chars, added "API gateway" keyword Rewritten with benchmark framing
30 gRPC-Web No title change Rewritten for clarity

SEO principles applied

  1. Keyword-first titles: Primary keyword (APISIX, plugin name, technology) appears early in the title
  2. Search-intent alignment: Titles reframed from announcements ("Coming soon!", "Announcing") to how-to/guide format
  3. SERP-safe lengths: All titles ≤55 chars + | APISIX suffix = ≤64 chars in SERPs
  4. Description value props: Each description tells the reader what they'll learn, not just what the article "describes"
  5. Typo fixes: Corrected "APISX"→"APISIX", "OKat"→"Okta", "Wiht"→"With"

Optimize frontmatter title and description tags for the top 30 blog
articles by SEO impact score. Changes improve search visibility by:

- Shortening all titles to ≤55 chars (was 58-89 chars)
- Adding primary keywords (API gateway, APISIX, plugin names)
- Rewriting descriptions to ≤155 chars with clear value propositions
- Matching search intent (how-to, guide, benchmark framing)
- Removing non-evergreen language ('Coming soon!', 'Announcing')
- Fixing typos in existing metadata ('OKat' → 'Okta', 'APISX' → 'APISIX')

Articles cover: integrations (Keycloak, Vault, Kafka, Splunk, Dapr,
OpenTelemetry, ClickHouse, gRPC-Web, OpenWhisk, open-appsec, Ory Hydra),
security (mTLS, API security practices, CVE advisory), performance
benchmarks (APISIX vs Envoy, ARM servers, Google Cloud T2A), AI/ML load
balancing, Ingress Controller, Rust/WebAssembly plugins, geo-routing,
API monetization, and user case studies.
Copilot AI review requested due to automatic review settings April 10, 2026 00:29
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 blog post frontmatter to improve SEO for 30 high-impact English posts by rewriting title and description fields to better fit SERP length limits and improve keyword/value-proposition clarity.

Changes:

  • Updated title frontmatter for selected posts to be shorter and more keyword-focused.
  • Rewrote description frontmatter to be more concise and snippet-friendly.
  • Fixed a few typos/inconsistencies as part of the rewrites.

Reviewed changes

Copilot reviewed 30 out of 30 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
blog/en/blog/2025/07/31/load-balancing-between-ai-ml-api-with-apisix.md Shortened/reframed meta description for the AI/ML traffic splitting guide
blog/en/blog/2024/10/22/apisix-integrates-with-open-appsec.md Rewrote title + description for open-appsec WAF integration post
blog/en/blog/2024/02/27/secure-api-practices-apisix-2.md Rewrote title + condensed description for API security practices (part 2)
blog/en/blog/2024/02/20/secure-api-practices-apisix-1.md Rewrote title + condensed description for API security practices (part 1)
blog/en/blog/2023/12/26/zhengcaiyun-uses-apisix.md Rewrote title + description for Zhengcaiyun case study
blog/en/blog/2023/12/26/access-kafka-by-apisix.md Rewrote meta description for Kafka proxy + auth plugin post
blog/en/blog/2023/03/23/mtls-everywhere.md Rewrote title + description for mTLS configuration post
blog/en/blog/2023/01/02/accessing_apisix-dashboard_from_everywhere_with_keycloak_authentication.md Rewrote title + description for APISIX Dashboard + Keycloak post
blog/en/blog/2022/11/09/georouting-apisix.md Rewrote meta description for geo-routing/GeoIP post
blog/en/blog/2022/10/05/rust-apisix.md Rewrote title + description for Rust/Wasm plugin rewrite post
blog/en/blog/2022/09/08/api-monetization-using-stack.md Rewrote title + meta description for API monetization post
blog/en/blog/2022/08/12/arm-performance-google-aws-azure-with-apisix.md Rewrote title + meta description for ARM server benchmark post
blog/en/blog/2022/07/22/how-is-google-cloud-tau-t2a-performing.md Rewrote title + meta description for Google Cloud T2A/T2D benchmark post
blog/en/blog/2022/07/04/apisix-integrates-with-hydra.md Rewrote meta description for Ory Hydra / OIDC integration post
blog/en/blog/2022/03/04/apigateway-clickhouse-makes-logging-easier.md Rewrote meta description for ClickHouse logging plugin post
blog/en/blog/2022/02/28/apisix-integration-opentelemetry-plugin.md Rewrote title + meta description for OpenTelemetry tracing plugin post
blog/en/blog/2022/02/10/splunk-apisix-integration.md Rewrote title + meta description for Splunk HEC logging integration post
blog/en/blog/2022/01/25/apisix-grpc-web-integration.md Rewrote meta description for gRPC-Web proxying post
blog/en/blog/2022/01/21/apisix-hashicorp-vault-integration.md Rewrote title + meta description for HashiCorp Vault integration post
blog/en/blog/2022/01/17/apisix-kafka-integration.md Rewrote title + meta description for Kafka real-time logging post
blog/en/blog/2021/12/24/apisix-integrate-openwhisk-plugin.md Rewrote title + meta description for OpenWhisk plugin post
blog/en/blog/2021/12/10/integrate-keycloak-auth-in-apisix.md Rewrote title + meta description for Keycloak OIDC integration post
blog/en/blog/2021/11/17/dapr-with-apisix.md Rewrote title + meta description for Dapr + APISIX Ingress integration post
blog/en/blog/2021/10/09/apisix-ingress-techblog.md Rewrote title + meta description for APISIX Ingress concepts/practice post
blog/en/blog/2021/08/25/Using-the-Apache-APISIX-OpenID-Connect-Plugin-for-Centralized-Authentication.md Rewrote title + meta description for centralized auth post
blog/en/blog/2021/08/16/Using-the-Apache-APISIX-OpenID-Connect-Plugin-for-Centralized-Authentication.md Rewrote title + meta description for Okta + OIDC post
blog/en/blog/2021/08/06/using-apache-apisix-to-improve-the-observability-of-nginx.md Rewrote title + meta description for Nginx observability post
blog/en/blog/2021/06/21/use-Java-to-write-Apache-APISIX-plugins.md Rewrote meta description for Java plugin runner post
blog/en/blog/2021/06/17/Apache-APISIX-Dashboard-Access-Control-Bypass-Vulnerability-Announcement.md Rewrote title + meta description for CVE-2021-33190 advisory
blog/en/blog/2021/06/10/Apache-APISIX-and-Envoy-performance-comparison.md Rewrote title + meta description for APISIX vs Envoy benchmark post

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

Comment thread blog/en/blog/2023/12/26/access-kafka-by-apisix.md
@Yilialinn Yilialinn merged commit 2fe09ab into apache:master Apr 12, 2026
7 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