Skip to content

docs: add Long Term Support (LTS) README section#2505

Open
MikeMcC399 wants to merge 3 commits into
nodejs:mainfrom
MikeMcC399:lts-tags
Open

docs: add Long Term Support (LTS) README section#2505
MikeMcC399 wants to merge 3 commits into
nodejs:mainfrom
MikeMcC399:lts-tags

Conversation

@MikeMcC399
Copy link
Copy Markdown
Contributor

Description

Add LTS section to README.md

Motivation and Context

The README.md does not discuss lts and floating tags

LTS Current
node:lts-alpine node:alpine
node:lts-bookworm node:bookworm
node:lts-bullseye node:bullseye
node:lts-trixie node:trixie
node:lts-slim node:slim

https://nodejs.org/en/about/previous-releases states

Production applications should only use Active LTS or Maintenance LTS releases.

Testing Details

N/A - documentation change only

Types of changes

  • Documentation
  • Version change (Update, remove or add more Node.js versions)
  • Variant change (Update, remove or add more variants, or versions of variants)
  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Other (none of the above)

Checklist

  • My code follows the code style of this project.
  • My change requires a change to the documentation.
  • I have updated the documentation accordingly.
  • I have read the CONTRIBUTING.md document.
  • All new and existing tests passed.

@MikeMcC399 MikeMcC399 marked this pull request as ready for review May 14, 2026 11:52
@nschonni
Copy link
Copy Markdown
Member

Maybe this is more a subheading like https://github.com/nodejs/docker-node#nodeversion. Realizing that there is probably a missing similar explanation for the node:<codename>

@MikeMcC399
Copy link
Copy Markdown
Contributor Author

MikeMcC399 commented May 15, 2026

Maybe this is more a subheading like https://github.com/nodejs/docker-node#nodeversion. Realizing that there is probably a missing similar explanation for the node:<codename>

I've added a new entry node:lts so that it follows the existing scheme. The full text is however kept separate however, since the goal is to discuss the supportability aspects.

At some stage it would be worth considering restructuring the image variant section since it is difficult to extend. This addition is a bit of a compromise to add the supportability information for LTS without disturbing the rest of the text.

@MikeMcC399
Copy link
Copy Markdown
Contributor Author

@MikeMcC399 MikeMcC399 requested review from nschonni and sxa May 15, 2026 08:03
Copy link
Copy Markdown
Member

@sxa sxa left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approving regardless - will let others decide or comment on whether the LTS distinction should be changed.

Comment thread README.md Outdated
Co-authored-by: Stewart X Addison <6487691+sxa@users.noreply.github.com>
@MikeMcC399
Copy link
Copy Markdown
Contributor Author

Approving regardless - will let others decide or comment on whether the LTS distinction should be changed.

Thanks! I'll leave the PR open until beginning of next week though to allow for other feeback.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants