Skip to content

Generate complete SEO and multi-package llms metadata - #641

Merged
PrzemyslawKlys merged 13 commits into
mainfrom
codex/api-seo-descriptions
Jul 27, 2026
Merged

Generate complete SEO and multi-package llms metadata#641
PrzemyslawKlys merged 13 commits into
mainfrom
codex/api-seo-descriptions

Conversation

@PrzemyslawKlys

@PrzemyslawKlys PrzemyslawKlys commented Jul 27, 2026

Copy link
Copy Markdown
Member

What changed

  • generate page-specific search descriptions for API indexes, types, cmdlets, suite portals, and taxonomy pages
  • keep localized taxonomy descriptions source-language, page-specific, and within the intended search-snippet range even for pathologically sparse content
  • generate multi-package llms.txt, llms.json, and llms-full.txt for .NET suites and PowerShell modules
  • derive suite versions from package manifests, preserve explicit overrides, and keep unknown/mixed-version semantics accurate
  • add a curated discovery Markdown input shared by llms.txt and llms-full.txt
  • emit correct NuGet, .NET tool, and PowerShell installation guidance
  • derive sitemap source dates correctly when a website lives below the repository root
  • track configured package manifests in pipeline fingerprints and accept both packageFiles aliases in the schema
  • parse active PowerShell manifest metadata without treating commented assignments as package facts
  • fail clearly for missing configured package manifests and report accurate package counts
  • keep the LLMS generator maintainable through a semantic package-metadata partial

Why

Generated API metadata, AI discovery files, and sitemap freshness belong in PowerForge. Keeping those rules in the shared generator prevents per-site copies and lets OfficeIMO and future sites publish verifiable discovery metadata from one owner.

Validation

  • 40 focused taxonomy-SEO, sitemap-freshness, LLMS-generation, schema, fingerprint, manifest-comment, sparse-localization, API-fallback, and prerelease tests pass
  • PowerForge.Web.Cli builds successfully on .NET 10
  • the generator split is 753 and 261 lines
  • the full local suite passed 5,214 of 5,216 tests; the transient async lifecycle test passed on targeted rerun, while the remaining Windows CRLF failure is an unchanged macOS-script expectation
  • OfficeIMO's complete 3,774-page pipeline passed against exact PowerForge head 99aed49fecbe9a6b9b3eeee4951d5cd57a9bb64e, producing 3,773 sitemap URLs, 199 lastmod values, zero SEO errors/new issues, and a clean link/asset audit

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: daa6fc0c19

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread PowerForge.Web/Services/WebSiteBuilder.TaxonomySeo.cs Outdated
Comment thread PowerForge.Web/Services/WebApiDocsGenerator.Seo.cs Outdated
Comment thread PowerForge.Web/Services/WebApiDocsGenerator.Seo.cs Outdated
Comment thread PowerForge.Web/Services/WebApiDocsGenerator.Seo.cs Outdated
Comment thread PowerForge.Web/Services/WebApiDocsGenerator.Seo.cs Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e8d51c97e5

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread PowerForge.Web/Services/WebApiDocsGenerator.Seo.cs Outdated
Comment thread PowerForge.Web/Services/WebSiteBuilder.TaxonomySeo.cs Outdated
Comment thread PowerForge.Web/Services/WebSiteBuilder.ContentDiscovery.cs Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 52818accff

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread PowerForge.Web/Services/WebApiDocsGenerator.Seo.cs Outdated
Comment thread PowerForge.Web/Services/WebSiteBuilder.TaxonomySeo.cs Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 4479e08242

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread PowerForge.Web/Services/WebApiDocsGenerator.Seo.cs Outdated
Comment thread PowerForge.Web/Services/WebApiDocsGenerator.Seo.cs
Comment thread PowerForge.Web/Services/WebApiDocsGenerator.Seo.cs Outdated
Comment thread PowerForge.Web/Services/WebApiDocsGenerator.Seo.cs Outdated
Comment thread PowerForge.Web/Services/WebSiteBuilder.TaxonomySeo.cs Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c23a2abd78

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread PowerForge.Web/Services/WebLlmsGenerator.cs Outdated
Comment thread PowerForge.Web/Services/WebLlmsGenerator.cs Outdated
Comment thread PowerForge.Web/Services/WebLlmsGenerator.cs
@PrzemyslawKlys PrzemyslawKlys changed the title Generate complete SEO descriptions for API pages Generate complete SEO and multi-package llms metadata Jul 27, 2026

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 62f5de1a4b

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread PowerForge.Web/Services/WebLlmsGenerator.cs Outdated
Comment thread PowerForge.Web/Services/WebLlmsGenerator.cs Outdated
Comment thread PowerForge.Web/Services/WebApiDocsGenerator.Seo.cs Outdated
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, add credits to your account and enable them for code reviews in your settings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f630bb55e8

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread PowerForge.Web.Cli/WebPipelineRunner.Tasks.Content.cs
Comment thread PowerForge.Web.Cli/WebPipelineRunner.Tasks.Content.cs
Comment thread PowerForge.Web/Services/WebLlmsGenerator.cs Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 15497ba446

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread PowerForge.Web/Services/WebSiteBuilder.TaxonomySeo.cs Outdated
Comment thread PowerForge.Web/Services/WebLlmsGenerator.cs Outdated
Comment thread PowerForge.Web/Services/WebSiteBuilder.TaxonomySeo.cs Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f40719ac03

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread PowerForge.Web/Services/WebLlmsGenerator.cs Outdated
Comment thread PowerForge.Web/Services/WebSiteBuilder.TaxonomySeo.cs Outdated
Comment thread PowerForge.Web/Services/WebLlmsGenerator.cs Outdated
Comment thread PowerForge.Web/Services/WebApiDocsGenerator.Seo.cs
Comment thread PowerForge.Web/Services/WebLlmsGenerator.cs
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, add credits to your account and enable them for code reviews in your settings.

@PrzemyslawKlys
PrzemyslawKlys merged commit e7884ac into main Jul 27, 2026
7 checks passed
@PrzemyslawKlys
PrzemyslawKlys deleted the codex/api-seo-descriptions branch July 27, 2026 21:25
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.

1 participant