Skip to content

[docs] AI Stack — Token Plan: add screenshots to the A-Z guide — VI + EN - #34

Merged
greennode-vdb merged 2 commits into
mainfrom
huyenttn3
Aug 5, 2026
Merged

[docs] AI Stack — Token Plan: add screenshots to the A-Z guide — VI + EN#34
greennode-vdb merged 2 commits into
mainfrom
huyenttn3

Conversation

@greennode-vdb

Copy link
Copy Markdown
Contributor

Why

The images on the Token Plan pages were reported as "not syncing to GitBook". They are in fact fine — verified end to end:

  • 14/14 refs on the Buy/Manage pages resolve, with correct filename casing (matters because GitBook runs on Linux and is case-sensitive, while Windows is not — a case mismatch renders locally and 404s after sync)
  • all assets tracked and present on main
  • every image on the live site returns http 200 image/png, and the git-blob-<sha> in each rendered URL matches the blob SHA on main, so GitBook is serving the current version, not a stale cache

The real problem was different: the A-Z guide had zero screenshots — the only Token Plan page with none, 24 sections of solid text. That is what read as broken image sync, especially since it is the page handed to end users.

What changed

Adds 8 screenshots per language to the A-Z guide, reusing the assets already published for the Buy/Manage pages, plus one new capture of the Package Detail modal.

Section Image
2. Pick a plan packages-list.png, view-detail-package.png (new)
4. Get the API key + Base URL detail-tab-models.png, detail-tab-keys.png
6.1 View your purchased plans my-token-plan-list.png
6.2 Create a key Create-subscription-key.png
6.3 Auto-renew turn-off-auto-renew.png
6.4 Delete a plan delete-plan-alert.png

New asset committed to both Vietnamese/.gitbook/assets/Package-plan/ and English/.gitbook/assets/Package-plan/ under the same filename, so the two languages stay in parity.

Verification

30 image refs across all 8 Token Plan pages: 0 missing, 0 case mismatches. Both A-Z guides carry the 8 images at identical positions and still mirror at 24 headings each. Links, anchors, tables, and hint/tabs blocks all still pass.

Still missing a screenshot

Two spots in the A-Z guide have no asset available:

  1. Section 3 — the Confirm & checkout screen (Plan name, Balance, Confirm & Pay). This is the step where money leaves the account, so it is the one most worth illustrating.
  2. Section 7 — the Usage & Cost dashboard filtered by a subscription-key.

🤖 Generated with Claude Code

Hana-Hasa and others added 2 commits August 5, 2026 13:36
The A-Z guide was the only Token Plan page with no screenshots at all, which
read as broken image sync. Adds 8 images per language, reusing the assets
already published for the Buy/Manage pages plus one new Package Detail capture.

New asset: .gitbook/assets/Package-plan/view-detail-package.png (VI + EN)

Placement (identical in both languages):
  section 2   packages-list, view-detail-package
  section 4   detail-tab-models, detail-tab-keys
  section 6.1 my-token-plan-list
  section 6.2 Create-subscription-key
  section 6.3 turn-off-auto-renew
  section 6.4 delete-plan-alert

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
…I + EN

The Package Detail screenshot shows the Included Models table columns are
Model / Hosting mode / Status / Token quota / Request quota — there is no
"Model code" or "Provider" column, so readers were told to note a Model code
from a table that does not show one. The model code is revealed by clicking
the model name (and also listed in Plan Detail -> Models tab).

Fixed in section 2 of both A-Z guides and in the Buy pages. The Plan Detail
-> Models tab descriptions were already correct and are unchanged.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@greennode-vdb
greennode-vdb merged commit bd8980e into main Aug 5, 2026
8 checks passed
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.

2 participants