Skip to content

docs(airbox-q900): clarify OS type of system image downloads - #2088

Open
tzz-radxa wants to merge 1 commit into
radxa-docs:mainfrom
tzz-radxa:docs/q900-download-os-clarify-20260903
Open

docs(airbox-q900): clarify OS type of system image downloads#2088
tzz-radxa wants to merge 1 commit into
radxa-docs:mainfrom
tzz-radxa:docs/q900-download-os-clarify-20260903

Conversation

@tzz-radxa

Copy link
Copy Markdown

Background

Triggered by a real support question (2026-09-03): an internal colleague looking at the AIRbox Q900 download page asked "Q900 的这两个系统是 Debian 吗?有 Ubuntu 系统吗?" — the page listed two files under System Images with zero explanation of what they are.

Problem

The Q900 download page (download.md, CN + EN) shows:

  • radxa-airbox-q900_noble_gnome_r1 — no OS/desktop explanation; the Radxa image naming (noble = Ubuntu 24.04 Noble Numbat, gnome = GNOME desktop) is not self-evident to users.
  • qcs9075-provision — listed as a "system image", but it is actually a UFS provisioning toolkit (370 KiB), not an OS. Users may mistake it for a bootable system.

Change (docs-only)

  • Annotate radxa-airbox-q900_noble_gnome_r1 as Ubuntu 24.04 (Noble) + GNOME desktop system image (r1 stable).
  • Add a :::note explaining the image naming convention (noble = Ubuntu 24.04, gnome = GNOME desktop, r/t prefix = stable/test).
  • Annotate qcs9075-provision as UFS provisioning toolkit (not an OS image) and cross-link the Install System to Onboard UFS guide.

Both CN (docs/fogwise/airbox-q900/download.md) and EN (i18n/.../fogwise/airbox-q900/download.md) updated in sync.

Validation

  • Naming verified against dl.radxa.com/fogwise/airbox-q900/images/ (older artifact radxa-airbox-q900-ubuntu-noble-gnome-t4.tar.gz) and radxa-build/radxa-airbox-q900 releases (noble_gnome_r1/r2, noble_kde_t*).
  • qcs9075-provision usage verified in getting-started/install-system/onboard-ufs.md (UFS provisioning step).
  • pre-commit hooks all pass (incl. doc translation guard).

Impact

Reduces confusion for users and staff when choosing the correct image/tool from the Q900 download page.

The download page lists two files under System Images without any
explanation. Internal staff asked whether the listed items are Debian
or Ubuntu, and whether qcs9075-provision is an OS.

Clarify that:
- radxa-airbox-q900_noble_gnome_r1 is the Ubuntu 24.04 (Noble) +
  GNOME desktop system image, with a note on the image naming
  convention (noble = Ubuntu 24.04, gnome/kde = desktop, r/t prefix).
- qcs9075-provision is a UFS provisioning toolkit, not an OS image,
  and link to the onboard UFS install guide.
@tzz-radxa
tzz-radxa requested a review from a team as a code owner September 3, 2026 11:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant