fix(docs-platform): Landing page header formatting

[lena-larionova]

Description

Fixes the following issues:

• Poor/inconsistent spacing between headers and tiles on landing pages
• Proper header nesting for LLM mode
• ’ was not being displayed correctly in LLM mode, cleaned up to replace with ' in all landing pages
  

Added a description to headers; @fabianrbz let me know if that was a bad idea. I couldn't find another clean way to attribute a description/intro text to a header without having it be subject to the column count rules.

Edit: I fixed formatting, I think this is the way forward.

Old - see spacing between tiles and after the description text:

New:

Preview Links

So many.

When looking at any guides in the preview, check the .md output of the page as well. The changes in this PR should've fixed some header nesting issues.

Example pages:
https://deploy-preview-4961--kongdeveloper.netlify.app/waf/
https://deploy-preview-4961--kongdeveloper.netlify.app/waf.md

https://deploy-preview-4961--kongdeveloper.netlify.app/konnect/
https://deploy-preview-4961--kongdeveloper.netlify.app/konnect.md

https://deploy-preview-4961--kongdeveloper.netlify.app/ai-gateway/
https://deploy-preview-4961--kongdeveloper.netlify.app/ai-gateway.md

https://deploy-preview-4961--kongdeveloper.netlify.app/ai-gateway/ai-clis/
https://deploy-preview-4961--kongdeveloper.netlify.app/ai-gateway/ai-clis.md

[netlify]

✅ Deploy Preview for kongdeveloper ready!

Name	Link
🔨 Latest commit	b884c4c
🔍 Latest deploy log	https://app.netlify.com/projects/kongdeveloper/deploys/69ea589938e9e300081ffc1f
😎 Deploy Preview	https://deploy-preview-4961--kongdeveloper.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[Copilot]

Pull request overview

This PR updates the landing page YAML structure and header rendering to improve spacing/consistency between section headers and tile grids, and to provide better header semantics for LLM/markdown output.

Changes:

• Introduces header.description rendering in the landing page header include.
• Refactors many landing pages to move intro text into header fields (sub_text/description) and to set explicit column_count for more consistent tile layouts.
• Cleans up some inconsistent/extra columns blocks and spacing artifacts in landing page YAML.

Reviewed changes

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

Show a summary per file

File	Description
app/_landing_pages/mesh/guides.yaml	Adds header.description and adjusts column counts/spacing for sections.
app/_landing_pages/mesh.yaml	Adds explicit column_count for tile sections.
app/_landing_pages/konnect-platform/konnect-mcp.yaml	Moves installation intro text into header.description and normalizes columns.
app/_landing_pages/insomnia/plugins.yaml	Removes a trailing “References” section from the landing page.
app/_landing_pages/insomnia/mock-servers.yaml	Simplifies intro text and improves wording/formatting.
app/_landing_pages/insomnia/manage-insomnia.yaml	Moves intro text into header.sub_text and sets column_count for “Security”.
app/_landing_pages/insomnia/enterprise.yaml	Adds explicit column_count for the card grid.
app/_landing_pages/insomnia/authentication-authorization.yaml	Adds header.description and normalizes column_count placement.
app/_landing_pages/insomnia/ai-in-insomnia.yaml	Refactors sections to use top-level headers instead of structured_text headers.
app/_landing_pages/insomnia.yaml	Normalizes column_count usage for sections.
app/_landing_pages/gateway/traffic-control-and-routing.yaml	Converts section intro structured_text blocks into header.description + consistent grids.
app/_landing_pages/gateway/security.yaml	Converts “Vulnerability management” intro to header.description.
app/_landing_pages/gateway/secrets-management.yaml	Converts an intro structured_text block into header.description and removes redundant columns blocks.
app/_landing_pages/gateway/openid-connect.yaml	Adds explicit column_count for the examples grid.
app/_landing_pages/gateway/monitoring.yaml	Converts section intro structured_text into header.description and normalizes column_count.
app/_landing_pages/gateway/load-balancing.yaml	Moves page intro to sub_text and converts section intro to header.description.
app/_landing_pages/gateway/kong-manager.yaml	Converts section intros to header.description.
app/_landing_pages/gateway/authentication.yaml	Adds explicit column_count, adjusts card layout, and adds a “References” header row.
app/_landing_pages/gateway.yaml	Adds column_count for “Key functionality” and normalizes “Key references”.
app/_landing_pages/event-gateway.yaml	Normalizes column_count indentation.
app/_landing_pages/dev-portal/self-service.yaml	Removes extra spacing and normalizes header→columns adjacency.
app/_landing_pages/dev-portal/customizations/dev-portal-customizations.yaml	Adjusts a card block indentation to match updated structure.
app/_landing_pages/dev-portal.yaml	Normalizes header→columns adjacency and column_count indentation.
app/_landing_pages/dedicated-cloud-gateways.yaml	Attempts to add column_count for “More information” section (currently misstructured).
app/_landing_pages/custom-plugins.yaml	Converts structured_text section headers into header.description.
app/_landing_pages/custom-dashboards.yaml	Normalizes header→columns adjacency.
app/_landing_pages/ai-gateway/ai-data-gov.yaml	Converts section intro structured_text into header.description.
app/_landing_pages/ai-gateway/ai-clis.yaml	Converts section intro structured_text into header.description.
app/_landing_pages/ai-gateway/a2a.yaml	Converts section intro structured_text into header.description.
app/_landing_pages/ai-gateway.yaml	Converts multiple section intro structured_text blocks into header.description and normalizes grids.
app/_includes/landing_pages/header.md	Adds rendering support for header.description.

[cloudjumpercat]

Started reviewing, looks like when it uses description: that isn't rendered in the LLM markdown, which in some cases this could be a lot of conceptual text that's cut:

[lena-larionova]

Fixed, I missed updating another file.

[lena-larionova]

FYI I removed this because the list is empty: https://developer.konghq.com/insomnia/plugins/#references
Setting allow_empty: false didn't work either.