Support-tier vocabulary: release pages use five values, the Board Support Rules define four different ones
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 5/5
- 预计耗时
- 一周以上
- 新手友好度
- 25/100
- Issue 类型
- 文档
- 描述清晰度
- 基本清楚
- 活跃度
- 冷清
- 技术栈
- markdown
调研方向
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
TV box/.tvbhas 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.CSCandEOSare live values, not historical ones. The Rules page says "Community maintained ... represents combined former CSC ... and EOS", butarmbian/buildstill has 216.cscand 31.eosboard 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".WIPvsStaging. Same tier, two names. Pick one for both places.Platinum Supportappears on the homepage and in the Rules but has noconfig/boardsextension, 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,通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
armbian/documentation 的其他 Issue
-
document bootscript templating可能已有人在做 @swastiktawate 于 3 天前认领。 未关闭
难度 3/5 1-2 天 新手友好度 20/100
armbian/documentation#844 ·
维护者通常 1 天内回复
-
document how to run a quick test via qemu / incus可能已有人在做 @swastiktawate 于 3 天前认领。 未关闭
难度 2/5 1-3 小时 新手友好度 38/100
armbian/documentation#661 · 1 条评论 ·
维护者通常 1 天内回复
查看 armbian/documentation 的全部 Issue
相似的 Issue
-
难度 1/5 1 小时以内 新手友好度 88/100
public-apis/public-apis#9330 · 1 个 reaction ·
维护者通常 12 天内回复
-
approved author-page correction move-papers
难度 2/5 1-3 小时 新手友好度 62/100
acl-org/acl-anthology#11043 · 1 条评论 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 68/100
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 82/100
trezor/trezor-firmware#8357 ·
维护者通常 2 天内回复
-
A visiting liaison's death is announced as CITIZEN_DEATH and the scorer counts it as a citizen death未关闭
难度 2/5 1-3 小时 新手友好度 70/100
Layr-Labs/arena-fortress#241 ·
维护者通常 1 天内回复