Support-tier vocabulary: release pages use five values, the Board Support Rules define four different ones

未关闭
#995 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
5/5
预计耗时
一周以上
新手友好度
25/100
Issue 类型
文档
描述清晰度
基本清楚
活跃度
冷清
技术栈
markdown
领域
documentation

调研方向

Read the Board Support Rules and the homepage’s “Which hardware is supported?” section, then compare their labels with the “Board status changes” sections in docs/releases/*.md. The issue also points to scripts/generate-release-doc.py in armbian/armbian.github.io for how release labels are produced. Done means the open vocabulary questions have human decisions and the homepage explanation matches the agreed terminology.

由索引模型根据 Issue 内容生成。

描述

Blocking a homepage cleanup: the homepage explains three support tiers, generated release pages emit five different labels, and User-Guide_Board-Support-Rules.md — the source of truth — defines a fourth set. A reader who lands on /releases/26.8/ and sees

panther-x2: Standard support → EOS

has no way to map that onto the three buttons the homepage explains.

I stopped rather than invent definitions, per the brief. This needs a human decision before the homepage section can be rewritten.

Every distinct value found in generated release pages

From the "Board status changes" section of docs/releases/*.md (25.2 → 26.8). The generator (scripts/generate-release-doc.py in armbian/armbian.github.io) derives these from the config/boards/<board>.<ext> file extension in armbian/build:

Label rendered config/boards extension Boards on that extension today (armbian/build@79a3cc4) Defined in Board Support Rules?
Standard support .conf 142 ✅ Yes — "Standard Support"
CSC .csc 216 ⚠️ Only historically — named as a former status folded into "Community maintained"
EOS .eos 31 ⚠️ Only historically — same sentence
WIP .wip 0 ⚠️ Indirectly — the page calls this tier "Staging" and mentions WIP only in prose
TV box .tvb 14 ❌ Not defined anywhere. The FAQ discusses TV boxes, but not as a support tier

The three vocabularies, side by side

Homepage (/) Board Support Rules Generated release pages
Platinum Support Platinum Support (never appears)
Standard Support Standard Support Standard support
Community maintained Community maintained CSC, EOS
(absent) Staging WIP
(absent) (absent) TV box

What needs deciding

  1. TV box / .tvb has no definition at all. Is it a support tier, or a hardware category that happens to share the extension slot? Either it gets a section in the Board Support Rules, or the release generator should stop rendering it as a tier.
  2. CSC and EOS are live values, not historical ones. The Rules page says "Community maintained ... represents combined former CSC ... and EOS", but armbian/build still has 216 .csc and 31 .eos board files and the generator still emits both labels distinctly. Either the Rules page is out of date, or the generator should collapse both to "Community maintained".
  3. WIP vs Staging. Same tier, two names. Pick one for both places.
  4. Platinum Support appears on the homepage and in the Rules but has no config/boards extension, so it can never show up in a release page. Worth saying so explicitly on the homepage.

Once decided

The homepage "Which hardware is supported?" section should be updated to match the Rules page and cross-link to it, so the release pages' vocabulary is reachable from the tier explanation. That is a small follow-up PR — it just needs the answers above first.

/cc @armbian/documentation

主要语言
Python
星标
237
派生
210
平均合并
2 小时 58 分钟
30 天内合并 PR
117

环境准备

这个项目没有提供开发容器、Dockerfile 或贡献指南,环境需要你自己搭建:先看它的 README,通用步骤见我们的新手贡献指南。

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

armbian/documentation 的其他 Issue

查看 armbian/documentation 的全部 Issue

相似的 Issue

更多 Python Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。