Skip to content

docs: Add missing description front matter in f5ads docs - #2425

Open
travisamartin wants to merge 2 commits into
mainfrom
docs/f5ads-add-descriptions
Open

travisamartin wants to merge 2 commits into
mainfrom
docs/f5ads-add-descriptions

Conversation

@travisamartin

Copy link
Copy Markdown
Contributor

What changed

Adds the required description front matter field to 37 pages under
content/f5ads that were missing it, including section _index.md
pages. description is a required metadata field (used for search,
SEO, and content indexing) per the F5 metadata reference, so these
pages were non-compliant.

No other front matter fields or body content were changed.

Scope

Covers the AWS, Google Cloud, and shared platform subtrees:

  • Section landing pages: deploy, billing, monitoring, quickstart,
    nginx-configuration, ssl-tls-certificates, app-protect
  • Changelog and known-issues reference pages
  • How-to/concept pages: cost estimator, usage dashboard, access
    management, enable monitoring, enable NGINX logs, console guides

37 files changed, all additions (no deletions or body edits).

Approach

  • Each description is one sentence, under 160 characters, in double
    quotes, matching existing repo conventions (e.g.
    platform/_index.md, aws/billing/overview.md).
  • For pages that mirror each other across AWS/Google/platform (e.g.
    SSL certificate consoles, NGINX configuration rules), descriptions
    were adapted from the sibling page's existing description, swapping
    the product/cloud name.
  • For section index pages, I inspected the actual child pages in each
    directory to make sure the description reflects everything in the
    section (for example, noting that Google deployments can be created
    via Terraform in addition to the Console, and that monitoring
    sections also include a metrics catalog).

How to review

  • Diff is additive only — one new description: line per file.
  • Spot-check a few descriptions against their page content for
    accuracy.
  • make lint-markdown wasn't runnable in this environment (no Hugo/
    Docker available), so please run it locally or in CI before merge.

Before

image

After

image

This commit adds the required description metadata field to 37 pages
under content/f5ads that were missing it, including section _index.md
pages. Descriptions are one sentence, under 160 characters, and
reflect each page's or section's actual content.

Covers the AWS, Google Cloud, and platform (shared) subtrees:
- Section landing pages (deploy, billing, monitoring, quickstart,
  nginx-configuration, ssl-tls-certificates, app-protect)
- Changelogs and known-issues reference pages
- How-to and concept pages (cost estimator, usage dashboard, access
  management, enable monitoring, enable NGINX logs, console guides)

No other front matter fields or body content were changed.
@travisamartin
travisamartin requested a review from a team as a code owner October 22, 2026 19:29
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Oct 22, 2026
@travisamartin
travisamartin requested a review from a team October 22, 2026 19:40

@mjang mjang left a comment

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.

Ding! Lesson learned: treat the description field (almost) like UI text

@github-actions

Copy link
Copy Markdown

✅ Deploy Preview will be available once build job completes!

Name Link
😎 Deploy Preview https://frontdoor-test-docs.nginx.com/previews/docs/2425/

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants