docs(cubie a7z): align Micro HDMI tutorial with A7Z and fix display connection in Quick Start - #1949
Merged
Milir-Radxa merged 1 commit intoJul 28, 2026
Conversation
…rify display connection in quick start The a7z Micro HDMI tutorial page (docs/cubie/a7z/hardware-use/microhdmi.md) was still describing the A7A's full-size HDMI port, with every reference to the product and interface pointing at the wrong board. Update both the product name (Cubie A7A -> Cubie A7Z) and the interface name (HDMI -> Micro HDMI) in the introductory paragraph, the interface location tip, and the usage guide. Mirror the same wording changes in the English counterpart under i18n/en. Also refresh the 'With Display' section of the a7z quick start page (quickly-start.md) so it no longer instructs users to connect the monitor via a USB-C to HDMI/DP cable. A7Z exposes a Micro HDMI port and supports USB-C DP Alt mode, so state both options explicitly. Same fix applied to the English counterpart.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Fix two issues on the Cubie A7Z docs:
docs/cubie/a7z/hardware-use/microhdmi.md)was still describing the A7A's full-size HDMI port. Every reference to
the product and interface pointed at the wrong board.
docs/cubie/a7z/getting-started/quickly-start.md)told users to connect the monitor with a "USB-C to HDMI / DP cable",
which is not how the A7Z exposes display output.
Changes
docs/cubie/a7z/hardware-use/microhdmi.md(and English counterpart)Cubie A7A→Cubie A7ZHDMI(in the introductory paragraph, the interface-location tip, andthe usage guide) →
Micro HDMIdocs/cubie/a7z/getting-started/quickly-start.md(and English counterpart)correct A7Z options: the on-board Micro HDMI port or a USB-C
cable that supports DP Alt mode.
Both Chinese and English docs are updated in the same commit, so the
CN/EN sync guard stays green.
Why
The A7Z and A7A share a similar product family but expose different
display connectors: A7A has a full-size HDMI port, A7Z has a Micro HDMI
port plus a USB-C port that supports DP Alt mode. The current A7Z docs
pages still inherit the A7A text verbatim, which misleads users about
both the product and the required cable.
Impact
product name and the correct interface name.
monitor into the board's Micro HDMI port, or use a DP-Alt-mode
USB-C cable, instead of looking for a non-existent USB-C to HDMI/DP
cable.
cubie/a7a/a7a-hdmi-display.webpbecause the captured UI(Applications → Settings → Display → Resolution / Scale / Apply) is
shared with the A7A family and no dedicated A7Z screenshot exists
yet. A follow-up can swap it once an A7Z screenshot is available.
Verification
Local checks:
bash scripts/agent-doc-translation-guard.sh→ passed (CN/EN bothupdated).
bash scripts/agent-doc-drift-guard.sh→ passed.bash scripts/agent-doc-lint.sh --files <the four files>→ passed.Pages affected: