Skip to content

Create a way to display and manage content freshness #33

Open

Description

@bmuenzenmeyer

Broken out of nodejs/nodejs.org#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 nodejs/nodejs.org#7294 and build something that asks the owners to review the content twice a year?

Activity

  1. 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

    No labels
    No labels

    Type

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions