LearnNewsExamplesServices
Frontmatter
id7460
titleRefactor SEO Generator Script with Correct Data Sources
stateClosed
labels
enhancementai
assigneestobiu
createdAtOct 11, 2025, 11:36 AM
updatedAtNov 11, 2025, 1:28 PM
githubUrlhttps://github.com/neomjs/neo/issues/7460
authortobiu
commentsCount2
parentIssue7446
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[]
closedAtNov 11, 2025, 1:28 PM

Refactor SEO Generator Script with Correct Data Sources

Closed v11.1.0 enhancementai
tobiu
tobiu commented on Oct 11, 2025, 11:36 AM

This ticket is a follow-up to ticket-create-sitemap-generator-script.md. The initial implementation was completed correctly according to the original specification. However, the specification was flawed due to an oversight in identifying the correct data sources for our content.

The goal of this ticket is to refactor the existing script to use the correct source of truth, making it robust and accurate for generating our sitemap.xml and llm.txt files.

The correct data source is:

  1. learn/tree.json: This is the single source of truth for ALL internal content, including documentation, guides, tutorials, and internally-hosted blog posts.

The apps/portal/resources/data/blog.json file is for presentation purposes on the website and should be ignored for sitemap generation. The approach of scanning the learn/blog directory is also incorrect.

Acceptance Criteria

  1. Rename the script from buildScripts/sitemap.mjs to buildScripts/generate-seo-files.mjs.
  2. Refactor the script to ensure it uses learn/tree.json as the single source of truth for all internal URLs.
  3. Remove any logic that reads from apps/portal/resources/data/blog.json or scans the learn/blog directory.
  4. The script should export a primary function, e.g., getContentUrls({baseUrl}), that returns a clean, absolute array of all internal site URLs.
  5. Ensure that URL path segments are joined correctly using forward slashes (/).
  6. Update the generateSitemap() and generateLlmTxt() functions to use this corrected data source.
tobiu assigned to @tobiu on Oct 11, 2025, 11:36 AM
tobiu added parent issue #7446 on Oct 11, 2025, 11:36 AM
tobiu added the enhancement label on Oct 11, 2025, 11:36 AM
tobiu added the ai label on Oct 11, 2025, 11:36 AM
tobiu cross-referenced by PR #7456 on Oct 11, 2025, 11:43 AM
tobiu
tobiu Nov 11, 2025, 1:28 PM

already resolved.

tobiu closed this issue on Nov 11, 2025, 1:28 PM