Skip to content

Auto-link keywords, product names, and terminology within article text #237

@rvanmaanen

Description

@rvanmaanen

Automatically detect and link keywords, product names, and glossary terms within rendered article content. Two categories of links:

  • Product/technology keywords (e.g., "GPT-5-Codex", "GitHub Copilot", "Azure AI Foundry"): Link to a filtered content view showing all items tagged with or related to that keyword.
  • Terminology/glossary terms (e.g., sections, collections, items as defined in docs/terminology.md): Link to the term's definition or show a tooltip/popover on hover.

Implementation considerations:

  • Define a keyword-to-filter mapping (could reuse the existing tag system for products, a glossary data source for terminology).
  • Implement as a markdown post-processing step in the content pipeline.
  • Avoid over-linking: only link the first occurrence per article, skip headings, code blocks, and already-linked text.
  • Link product keywords to the appropriate section/collection filtered by the relevant tag.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions