Skip to content

[docs-scanner] Inconsistent Node.js versions across frontend and backend tutorials #25193

@github-actions

Description

@github-actions

File: content/manuals/extensions/extensions-sdk/build/backend-extension-tutorial.md and content/manuals/extensions/extensions-sdk/build/frontend-extension-tutorial.md

Issue

The Dockerfile examples in the backend and frontend tutorials use different Node.js and Alpine Linux versions, which could confuse developers building extensions with both components.

In backend-extension-tutorial.md (line ~179):

FROM node:17.7-alpine3.14 AS client-builder

In frontend-extension-tutorial.md (line ~79):

FROM --platform=$BUILDPLATFORM node:18.9-alpine3.15 AS client-builder

The versions differ:

  • Node.js: 17.7 vs 18.9
  • Alpine: 3.14 vs 3.15

Why this matters

Developers following both tutorials to build a complete extension (frontend + backend) would see different base images and wonder which version to use. Since these tutorials are meant to work together (the backend tutorial references the frontend tutorial), using consistent versions would reduce confusion and ensure compatibility.

The frontend tutorial also includes --platform=$BUILDPLATFORM for multi-platform builds, which the backend tutorial lacks, adding another inconsistency.

Suggested fix

Standardize both tutorials to use the same Node.js and Alpine versions. Use the newer versions from the frontend tutorial:

FROM --platform=$BUILDPLATFORM node:18.9-alpine3.15 AS client-builder

Or update both to use current LTS versions if these are outdated.


Found by nightly documentation quality scanner

Metadata

Metadata

Assignees

No one assigned

    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