LearnNewsExamplesServices
Frontmatter
id7771
titledocs(llms.txt): Enhance description for environment URLs
stateClosed
labels
documentationai
assigneestobiu
createdAtNov 13, 2025, 11:52 PM
updatedAtNov 13, 2025, 11:54 PM
githubUrlhttps://github.com/neomjs/neo/issues/7771
authortobiu
commentsCount0
parentIssuenull
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[]
closedAtNov 13, 2025, 11:54 PM

docs(llms.txt): Enhance description for environment URLs

Closed v11.3.0 documentationai
tobiu
tobiu commented on Nov 13, 2025, 11:52 PM

Description

The llms.txt file provides content for LLMs, and it currently lists only the zero-builds development mode URLs for applications and examples. However, Neo.mjs applications and examples are deployed across four distinct environments (development mode, dist/development, dist/esm, and dist/production), all serving identical functionality through different code delivery methods.

To provide better context for LLMs and clarify the canonical URL strategy, the introductory description within llms.txt needs to be enhanced.

Goal

Update the introductory description in apps/portal/llms.txt to:

  1. Explain that Neo.mjs applications and examples are available in four equivalent environments.
  2. Clarify that the URLs listed in llms.txt are specifically the development mode (zero-builds) versions.
  3. Provide instructions on how to access other environment versions (e.g., by prefixing the path with /dist/production/).
  4. Include a specific example for the Portal app, showing its various environment URLs and the root domain mapping.

Implementation Status

The necessary changes to the getLlmsTxt function in buildScripts/generateSeoFiles.mjs to update this description have already been implemented. This ticket serves to track the completion and verification of this documentation enhancement.

tobiu added the documentation label on Nov 13, 2025, 11:52 PM
tobiu added the ai label on Nov 13, 2025, 11:52 PM
tobiu assigned to @tobiu on Nov 13, 2025, 11:53 PM
tobiu referenced in commit bcaf2d9 - "docs(llms.txt): Enhance description for environment URLs #7771" on Nov 13, 2025, 11:54 PM
tobiu closed this issue on Nov 13, 2025, 11:54 PM