Skip to content

[Feature]: Automate Fern version registration on docs tag push #1289

Description

@pdmack

Prerequisites

  • I searched existing issues

Feature Description

When a docs/vX.Y.Z tag is pushed, the publish workflow should automatically:

  1. Generate fern/versions/vX.Y.Z.yml from the tag's docs/index.yml
  2. Add a version entry to fern/docs.yml
  3. Commit both back to main

Currently version entries must be created manually, which is error-prone and easy to forget after a release.

Additionally, the frozen version checkout should be hardened:

  • Guard against missing glob matches
  • Warn instead of failing hard on missing tags
  • Fix non-self-closing <img> tags in older tagged content (MDX safety)
  • Use yq instead of sed for YAML manipulation (version stamping)

Pattern proven in NVIDIA/topograph PRs #325, #327, #329, #330.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Fields

    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