Skip to content

Create a way to display and manage content freshness #7295

Open
@bmuenzenmeyer

Description

@bmuenzenmeyer
Collaborator

Broken out of #7197

Add metadata on pages to display last update (git has this info of course)

  • we noted a distinction between last reviewed (by a human) and last updated
  • eventually, create a means to flag when content gets stale, perhaps via an action that opens issues, if one exists

@AugustinMauroy had these thoughts

I'm more in favour of the version used in the example. Because a date has no value in relation to the runtime. In addition, having the version allows the contributor/collaborator to know if a document needs to be revised.
And from a functional point of view, I think we should add a bit to the MetaBar that allows you to install (redirect to the installation of the correct version).

This is interesting, but would create LTS rollover moments where we have all to review all content. I think that would quickly become the norm, twice a year.
I suppose that's better than arbitrary dates, TBH.

Given that thought experiment, maybe we build on #7294 and build something that asks the owners to review the content twice a year?

Activity

AugustinMauroy

AugustinMauroy commented on Feb 2, 2025

@AugustinMauroy
Member

I'm working on TS sub-section. And I had started mark which version how node is covered by the article. But the issue is:
it's not a unique version is a semver range. For example learn/typescript/run talk about node.js customization hooks that supported in >=v20.6.0 || >=v18.19.0.

so the last thing to validate before moving on to the code.
It's about knowing what to put in the MetaBar. There are several solutions:

  • Download to the correct version (IMO not very interesting)
  • Link to https://nodejs.org/docs/latest-v${mostRecentInSemver}.x/api/index.html
    If we set the mostRecentInSemver variable in the page context, we can have a new mdx component <LinkToApiDocs> which takes api as a props.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    contentIssues/pr concerning contentlearnIssues/pr concerning the learn section

    Type

    Projects

    Status

    📋 Backlog

    Milestone

    No milestone

    Relationships

    None yet

      Development

      No branches or pull requests

        Participants

        @bmuenzenmeyer@ovflowd@AugustinMauroy

        Issue actions

          Create a way to display and manage content freshness · Issue #7295 · nodejs/nodejs.org