发现自 #971 / PR #978 的实施过程(重写该节文案时,配图不在该单可修的面内 —— 修它需要新截图资产)。基线 origin/main = 01da4a8e。
事实
content/docs/getting-started/quick-tour.mdx:24(PR #978 前后行号不变,该行未被 #978 触碰):
[Sales performance dashboard](/screenshots/hotcrm/sales-dashboard/en.jpg)
它紧跟在「## 1. The home dashboard」一节末尾,读者会把它读成"这就是我落地时看到的那块盘"。但:
- 该节讲的是
nav_home 绑的 executive_dashboard(label Executive Overview,src/apps/crm.app.ts:33-39)。
- 图是
sales_dashboard(label Sales Performance),挂在 Sales 分组下的 nav_sales_dashboard(crm.app.ts:61),是第三块盘。
- 两块盘的 tile 几乎不重叠:executive 的 9 个是 Total Revenue (YTD) / Active Accounts / Total Contacts / Open Leads / Revenue Trend / Revenue by Industry / Pipeline by Stage / New Accounts / Accounts by Industry;sales 的是 Total Pipeline / Closed Won (QTD) / Open Opportunities / Avg Deal Size / … 只有共享工厂的 Pipeline by Stage 同时在两块盘上。
alt 文本本身没说谎(它写的就是 "Sales performance dashboard"),问题在位置:PR #978 刚把这一节的文字逐条写实到 Executive Overview 的真实 tile,文字与紧邻的图现在指向两块不同的盘。
三语不齐
| 文件 |
第 1 节配图 |
quick-tour.mdx:24 |
/screenshots/hotcrm/sales-dashboard/en.jpg |
quick-tour.zh-Hans.mdx |
/screenshots/hotcrm/sales-dashboard/zh-Hans.jpg |
quick-tour.zh-Hant.mdx |
无图 |
assets/screenshots/hotcrm/sales-dashboard/ 下只有 en.jpg / zh-Hans.jpg / meta.yaml,没有繁体资产,zh-Hant 因此一直是空的。assets/screenshots/hotcrm/ 全目录下也没有任何 executive dashboard 的截图(现有:campaign-detail / customer-360 / large-deal-approval / lead-detail / quote-pipeline / sales-dashboard / sales-pipeline / sales-representative-permissions)。
为什么这不是 #971 的一部分
#971 的面是该节的文字描述,src/ 与资产零改动;补图需要起应用、造种子数据、截 Executive Overview 至少两个语言版本,是另一类工作。所以 #978 只写实文字,把配图原样留下并在此立单。
可选处理(不预判)
- 补截 Executive Overview(en / zh-Hans,zh-Hant 是否需要单独一份取决于本仓有没有繁体界面 —— 应用只提供 en / zh-CN / ja-JP / es-ES 四种界面语言,zh-Hant 文档页一直借用简体界面截图,这本身也需要一个口径)。
- 把这张 Sales Performance 图移到讲 Sales Performance 的地方(第 2 节导航表附近,或
content/docs/analytics/dashboards.mdx),第 1 节暂时无图。
- 保留图但在文字里点明它是 Sales Performance 而非落地页 —— 成本最低,但等于在教程首屏承认配图不对版。
面:content/docs/getting-started/quick-tour{,.zh-Hans,.zh-Hant}.mdx 的配图行 + 可能的 assets/screenshots/hotcrm/。
Refs #960 #968 #971 #978
发现自 #971 / PR #978 的实施过程(重写该节文案时,配图不在该单可修的面内 —— 修它需要新截图资产)。基线
origin/main=01da4a8e。事实
content/docs/getting-started/quick-tour.mdx:24(PR #978 前后行号不变,该行未被 #978 触碰):它紧跟在「## 1. The home dashboard」一节末尾,读者会把它读成"这就是我落地时看到的那块盘"。但:
nav_home绑的executive_dashboard(label Executive Overview,src/apps/crm.app.ts:33-39)。sales_dashboard(label Sales Performance),挂在 Sales 分组下的nav_sales_dashboard(crm.app.ts:61),是第三块盘。alt 文本本身没说谎(它写的就是 "Sales performance dashboard"),问题在位置:PR #978 刚把这一节的文字逐条写实到 Executive Overview 的真实 tile,文字与紧邻的图现在指向两块不同的盘。
三语不齐
quick-tour.mdx:24/screenshots/hotcrm/sales-dashboard/en.jpgquick-tour.zh-Hans.mdx/screenshots/hotcrm/sales-dashboard/zh-Hans.jpgquick-tour.zh-Hant.mdxassets/screenshots/hotcrm/sales-dashboard/下只有en.jpg/zh-Hans.jpg/meta.yaml,没有繁体资产,zh-Hant 因此一直是空的。assets/screenshots/hotcrm/全目录下也没有任何 executive dashboard 的截图(现有:campaign-detail / customer-360 / large-deal-approval / lead-detail / quote-pipeline / sales-dashboard / sales-pipeline / sales-representative-permissions)。为什么这不是 #971 的一部分
#971 的面是该节的文字描述,
src/与资产零改动;补图需要起应用、造种子数据、截 Executive Overview 至少两个语言版本,是另一类工作。所以 #978 只写实文字,把配图原样留下并在此立单。可选处理(不预判)
content/docs/analytics/dashboards.mdx),第 1 节暂时无图。面:
content/docs/getting-started/quick-tour{,.zh-Hans,.zh-Hant}.mdx的配图行 + 可能的assets/screenshots/hotcrm/。Refs #960 #968 #971 #978