From 17359c64816771063205b9ddcaae27c31b61476e Mon Sep 17 00:00:00 2001 From: konojunya Date: Sun, 6 Sep 2026 07:38:44 +0900 Subject: [PATCH 1/2] docs: distinguish bundled core icons from available provider imports --- content/site/ja/language/themes-and-icons.md | 4 ++-- content/site/ko/language/themes-and-icons.md | 4 ++-- content/site/language/themes-and-icons.md | 4 ++-- content/site/zh/language/themes-and-icons.md | 4 ++-- generated/manifest.json | 8 ++++---- generated/site/ja/language/themes-and-icons.md | 4 ++-- generated/site/ko/language/themes-and-icons.md | 4 ++-- generated/site/language/themes-and-icons.md | 4 ++-- generated/site/zh/language/themes-and-icons.md | 4 ++-- 9 files changed, 20 insertions(+), 20 deletions(-) diff --git a/content/site/ja/language/themes-and-icons.md b/content/site/ja/language/themes-and-icons.md index ace5bab..0140fa0 100644 --- a/content/site/ja/language/themes-and-icons.md +++ b/content/site/ja/language/themes-and-icons.md @@ -51,7 +51,7 @@ Theme identifierは通常のStack identifier syntaxを使います。一度登 | `storage` | `kind-storage` | | `external` | `kind-external` | -現在のopen core catalogは`default`、`light`、`dark`にこの10 fallback identifierを持ちます。`postgresql`、`aws`、`github`などのvendor iconはまだありません。通常はsemanticな`kind`を選び、`icon`を省略してください。 +Open core catalogは`default`、`light`、`dark`にこの10種類の意味を表すfallbackを持ち、vendor logoは同梱しません。通常は意味に合う`kind`を選び、`icon`を省略してください。Vendorやprojectのmarkには、明示的に取り込む[provider icon pack](../guide/provider-icons)を使います。 ## 明示icon @@ -117,7 +117,7 @@ Semanticな`kind`と明示iconは独立して選びます。たとえば`icon "w Core catalogは現在、`postgresql`、`aws`、`github`、`docker`などのvendor / project markを収録していません。Effective themeにauthored icon identifierがなければ、node kindのfallbackでrenderを続け、warning `STK5001`を出します。 -上表のprovider-neutral iconを選ぶか、kind fallbackだけで役割が伝わる場合は`icon`を省略してください。Vendor markを別catalogへ収録するには、asset単位のlicense、redistribution、trademark reviewが必要です。 +上表のprovider-neutral iconを選ぶか、kind fallbackだけで役割が伝わる場合は`icon`を省略してください。監査済みvendor catalogは、アートワークの同梱ではなく[provider packの明示的な取り込み](../guide/provider-icons)で利用できます。各providerの規約を確認して同意し、取り込んだpackに保持されるassetごとのlicense・出典・帰属情報を守ってください。 ## Catalogとasset safety diff --git a/content/site/ko/language/themes-and-icons.md b/content/site/ko/language/themes-and-icons.md index 7ec9657..fc0b1f9 100644 --- a/content/site/ko/language/themes-and-icons.md +++ b/content/site/ko/language/themes-and-icons.md @@ -51,7 +51,7 @@ diagram "Dark architecture" { | `storage` | `kind-storage` | | `external` | `kind-external` | -현재 공개 코어 catalog는 `default`, `light`, `dark`에 이 열 개 식별자를 포함하지만 `postgresql`, `aws`, `github` 같은 벤더 아이콘은 아직 없습니다. 대부분의 문서는 의미에 맞는 `kind`를 선택하고 `icon`을 생략하세요. +공개 코어catalog는`default`, `light`, `dark`에 이 열 개의 의미 기반fallback을 제공하며 벤더 로고를 번들로 포함하지 않습니다. 대부분의 문서는 의미에 맞는`kind`를 선택하고`icon`을 생략하세요. 벤더나 프로젝트 마크가 필요하면 [공급자 아이콘 팩](../guide/provider-icons)을 명시적으로 가져오세요. ## 명시적 아이콘 @@ -117,7 +117,7 @@ diagram "Explicit icon" { 코어 catalog에는 현재 `postgresql`, `aws`, `github`, `docker` 같은 벤더 또는 프로젝트 마크가 없습니다. 유효 테마가 작성한 아이콘 식별자를 제공하지 않으면 노드 kind fallback으로 계속 렌더링하고 `STK5001` 경고를 냅니다. -위 표의 provider-neutral 아이콘을 사용하거나 kind fallback만으로 역할이 명확하면 `icon`을 생략하세요. 벤더 마크는 에셋별 license, 재배포 및 trademark review를 완료해야 별도 catalog에 포함할 수 있습니다. +위 표의provider-neutral 아이콘을 사용하거나kind fallback만으로 역할이 명확하면`icon`을 생략하세요. 검토된 벤더catalog는 아트워크 번들이 아닌 [명시적인 공급자 팩 가져오기](../guide/provider-icons)로 사용할 수 있습니다. 각 공급자의 약관을 읽고 동의하고, 가져온 팩에 보존된 에셋별 라이선스·출처·귀속 정보를 준수하세요. ## Catalog와 에셋 안전성 diff --git a/content/site/language/themes-and-icons.md b/content/site/language/themes-and-icons.md index c4bb400..401b270 100644 --- a/content/site/language/themes-and-icons.md +++ b/content/site/language/themes-and-icons.md @@ -51,7 +51,7 @@ Every theme provides one fallback for each node kind. If you omit `icon`, this i | `storage` | `kind-storage` | | `external` | `kind-external` | -The current open core catalog contains these ten fallback identifiers in `default`, `light`, and `dark`. It does not yet contain vendor icons such as `postgresql`, `aws`, or `github`. In most documents, choose the semantic `kind` and omit `icon`. +The open core catalog includes these ten semantic fallback identifiers in `default`, `light`, and `dark`, not vendor logos. In most documents, choose the semantic `kind` and omit `icon`. For vendor or project marks, use an explicitly imported [provider icon pack](../guide/provider-icons). ## Explicit icons @@ -117,7 +117,7 @@ Use the semantic `kind` independently from the explicit icon. For example, `icon The core catalog does not currently include vendor or project marks such as `postgresql`, `aws`, `github`, or `docker`. If the effective theme does not provide an authored icon identifier, rendering continues with the node's kind fallback and warning `STK5001`. -Prefer a provider-neutral icon above or omit `icon` when its kind fallback already communicates the role. Vendor marks require asset-specific license, redistribution, and trademark review before they can ship in a separate catalog. +Prefer a provider-neutral icon above or omit `icon` when its kind fallback already communicates the role. Audited vendor catalogs are available through [explicit provider-pack import](../guide/provider-icons), not bundled artwork. Review and accept each provider's terms; imported packs preserve asset-specific license, provenance, and attribution. ## Catalog and asset safety diff --git a/content/site/zh/language/themes-and-icons.md b/content/site/zh/language/themes-and-icons.md index 6d8fda0..8b58888 100644 --- a/content/site/zh/language/themes-and-icons.md +++ b/content/site/zh/language/themes-and-icons.md @@ -51,7 +51,7 @@ diagram "Dark architecture" { | `storage` | `kind-storage` | | `external` | `kind-external` | -当前开放核心 catalog 在 `default`、`light` 和 `dark` 中包含这十个回退标识符，尚不包含 `postgresql`、`aws` 或 `github` 等厂商图标。多数文档应选择语义 `kind` 并省略 `icon`。 +开放核心catalog在`default`、`light`和`dark`中提供这十个语义回退标识符，不附带厂商标志。多数文档应选择语义`kind`并省略`icon`。如需厂商或项目标志，请显式导入[供应商图标包](../guide/provider-icons)。 ## 显式图标 @@ -117,7 +117,7 @@ diagram "Explicit icon" { 核心 catalog 目前不包含 `postgresql`、`aws`、`github` 或 `docker` 等厂商或项目标志。如果有效主题没有编写的图标标识符，引擎会继续使用节点 kind 的回退图标渲染，并发出 `STK5001`。 -请优先选择上表中与厂商无关的图标；如果 kind 回退已能表达角色，也可以省略 `icon`。厂商标志只有在逐项完成资源 license、再分发和商标审查后，才能进入独立 catalog。 +请优先选择上表中与厂商无关的图标；如果kind回退已能表达角色，也可以省略`icon`。经过审查的厂商catalog可通过[显式导入供应商图标包](../guide/provider-icons)使用，而不是随产品附带图像。请阅读并接受各供应商条款，并保留包中每项资源的许可、来源和署名信息。 ## Catalog 与资源安全 diff --git a/generated/manifest.json b/generated/manifest.json index efa0e3c..10c08fe 100644 --- a/generated/manifest.json +++ b/generated/manifest.json @@ -88,7 +88,7 @@ }, { "path": "site/ja/language/themes-and-icons.md", - "sha256": "5a8db9a572b0b5231ea1620fb23107e6ac04a1f61dfcf25402d9e80944d3c23d" + "sha256": "a62ca441e0773d12140a518311b0fc79060f52d4450e29c6107c85ee45823613" }, { "path": "site/ja/reference/diagnostics-and-limits.md", @@ -144,7 +144,7 @@ }, { "path": "site/ko/language/themes-and-icons.md", - "sha256": "fb1eade6dd1b446bdcfa9ccfacbec2d6c702288ae254de939b79938536efb34a" + "sha256": "c860ae4ae7d9c642461852c97cd29b1971464a2ec5fce4fe2ea71e41cf19c65c" }, { "path": "site/ko/reference/diagnostics-and-limits.md", @@ -172,7 +172,7 @@ }, { "path": "site/language/themes-and-icons.md", - "sha256": "e82a930f3cb06ed9aa1f95fa160b5f6f8a51fca86ac2e52a1e53b75d2a0e2ff5" + "sha256": "4e2a59b62db144914fcd5b6f166524c9472d65a748432da339becad068c2ca7e" }, { "path": "site/reference/diagnostics-and-limits.md", @@ -228,7 +228,7 @@ }, { "path": "site/zh/language/themes-and-icons.md", - "sha256": "6d7cf0be5651274e72a511665e216ac9c08b4deeffc002415e3b6eb839011273" + "sha256": "376293b52fac1992c763d970410a72093f26275b97109d17e478d0e7257c339e" }, { "path": "site/zh/reference/diagnostics-and-limits.md", diff --git a/generated/site/ja/language/themes-and-icons.md b/generated/site/ja/language/themes-and-icons.md index ace5bab..0140fa0 100644 --- a/generated/site/ja/language/themes-and-icons.md +++ b/generated/site/ja/language/themes-and-icons.md @@ -51,7 +51,7 @@ Theme identifierは通常のStack identifier syntaxを使います。一度登 | `storage` | `kind-storage` | | `external` | `kind-external` | -現在のopen core catalogは`default`、`light`、`dark`にこの10 fallback identifierを持ちます。`postgresql`、`aws`、`github`などのvendor iconはまだありません。通常はsemanticな`kind`を選び、`icon`を省略してください。 +Open core catalogは`default`、`light`、`dark`にこの10種類の意味を表すfallbackを持ち、vendor logoは同梱しません。通常は意味に合う`kind`を選び、`icon`を省略してください。Vendorやprojectのmarkには、明示的に取り込む[provider icon pack](../guide/provider-icons)を使います。 ## 明示icon @@ -117,7 +117,7 @@ Semanticな`kind`と明示iconは独立して選びます。たとえば`icon "w Core catalogは現在、`postgresql`、`aws`、`github`、`docker`などのvendor / project markを収録していません。Effective themeにauthored icon identifierがなければ、node kindのfallbackでrenderを続け、warning `STK5001`を出します。 -上表のprovider-neutral iconを選ぶか、kind fallbackだけで役割が伝わる場合は`icon`を省略してください。Vendor markを別catalogへ収録するには、asset単位のlicense、redistribution、trademark reviewが必要です。 +上表のprovider-neutral iconを選ぶか、kind fallbackだけで役割が伝わる場合は`icon`を省略してください。監査済みvendor catalogは、アートワークの同梱ではなく[provider packの明示的な取り込み](../guide/provider-icons)で利用できます。各providerの規約を確認して同意し、取り込んだpackに保持されるassetごとのlicense・出典・帰属情報を守ってください。 ## Catalogとasset safety diff --git a/generated/site/ko/language/themes-and-icons.md b/generated/site/ko/language/themes-and-icons.md index 7ec9657..fc0b1f9 100644 --- a/generated/site/ko/language/themes-and-icons.md +++ b/generated/site/ko/language/themes-and-icons.md @@ -51,7 +51,7 @@ diagram "Dark architecture" { | `storage` | `kind-storage` | | `external` | `kind-external` | -현재 공개 코어 catalog는 `default`, `light`, `dark`에 이 열 개 식별자를 포함하지만 `postgresql`, `aws`, `github` 같은 벤더 아이콘은 아직 없습니다. 대부분의 문서는 의미에 맞는 `kind`를 선택하고 `icon`을 생략하세요. +공개 코어catalog는`default`, `light`, `dark`에 이 열 개의 의미 기반fallback을 제공하며 벤더 로고를 번들로 포함하지 않습니다. 대부분의 문서는 의미에 맞는`kind`를 선택하고`icon`을 생략하세요. 벤더나 프로젝트 마크가 필요하면 [공급자 아이콘 팩](../guide/provider-icons)을 명시적으로 가져오세요. ## 명시적 아이콘 @@ -117,7 +117,7 @@ diagram "Explicit icon" { 코어 catalog에는 현재 `postgresql`, `aws`, `github`, `docker` 같은 벤더 또는 프로젝트 마크가 없습니다. 유효 테마가 작성한 아이콘 식별자를 제공하지 않으면 노드 kind fallback으로 계속 렌더링하고 `STK5001` 경고를 냅니다. -위 표의 provider-neutral 아이콘을 사용하거나 kind fallback만으로 역할이 명확하면 `icon`을 생략하세요. 벤더 마크는 에셋별 license, 재배포 및 trademark review를 완료해야 별도 catalog에 포함할 수 있습니다. +위 표의provider-neutral 아이콘을 사용하거나kind fallback만으로 역할이 명확하면`icon`을 생략하세요. 검토된 벤더catalog는 아트워크 번들이 아닌 [명시적인 공급자 팩 가져오기](../guide/provider-icons)로 사용할 수 있습니다. 각 공급자의 약관을 읽고 동의하고, 가져온 팩에 보존된 에셋별 라이선스·출처·귀속 정보를 준수하세요. ## Catalog와 에셋 안전성 diff --git a/generated/site/language/themes-and-icons.md b/generated/site/language/themes-and-icons.md index c4bb400..401b270 100644 --- a/generated/site/language/themes-and-icons.md +++ b/generated/site/language/themes-and-icons.md @@ -51,7 +51,7 @@ Every theme provides one fallback for each node kind. If you omit `icon`, this i | `storage` | `kind-storage` | | `external` | `kind-external` | -The current open core catalog contains these ten fallback identifiers in `default`, `light`, and `dark`. It does not yet contain vendor icons such as `postgresql`, `aws`, or `github`. In most documents, choose the semantic `kind` and omit `icon`. +The open core catalog includes these ten semantic fallback identifiers in `default`, `light`, and `dark`, not vendor logos. In most documents, choose the semantic `kind` and omit `icon`. For vendor or project marks, use an explicitly imported [provider icon pack](../guide/provider-icons). ## Explicit icons @@ -117,7 +117,7 @@ Use the semantic `kind` independently from the explicit icon. For example, `icon The core catalog does not currently include vendor or project marks such as `postgresql`, `aws`, `github`, or `docker`. If the effective theme does not provide an authored icon identifier, rendering continues with the node's kind fallback and warning `STK5001`. -Prefer a provider-neutral icon above or omit `icon` when its kind fallback already communicates the role. Vendor marks require asset-specific license, redistribution, and trademark review before they can ship in a separate catalog. +Prefer a provider-neutral icon above or omit `icon` when its kind fallback already communicates the role. Audited vendor catalogs are available through [explicit provider-pack import](../guide/provider-icons), not bundled artwork. Review and accept each provider's terms; imported packs preserve asset-specific license, provenance, and attribution. ## Catalog and asset safety diff --git a/generated/site/zh/language/themes-and-icons.md b/generated/site/zh/language/themes-and-icons.md index 6d8fda0..8b58888 100644 --- a/generated/site/zh/language/themes-and-icons.md +++ b/generated/site/zh/language/themes-and-icons.md @@ -51,7 +51,7 @@ diagram "Dark architecture" { | `storage` | `kind-storage` | | `external` | `kind-external` | -当前开放核心 catalog 在 `default`、`light` 和 `dark` 中包含这十个回退标识符，尚不包含 `postgresql`、`aws` 或 `github` 等厂商图标。多数文档应选择语义 `kind` 并省略 `icon`。 +开放核心catalog在`default`、`light`和`dark`中提供这十个语义回退标识符，不附带厂商标志。多数文档应选择语义`kind`并省略`icon`。如需厂商或项目标志，请显式导入[供应商图标包](../guide/provider-icons)。 ## 显式图标 @@ -117,7 +117,7 @@ diagram "Explicit icon" { 核心 catalog 目前不包含 `postgresql`、`aws`、`github` 或 `docker` 等厂商或项目标志。如果有效主题没有编写的图标标识符，引擎会继续使用节点 kind 的回退图标渲染，并发出 `STK5001`。 -请优先选择上表中与厂商无关的图标；如果 kind 回退已能表达角色，也可以省略 `icon`。厂商标志只有在逐项完成资源 license、再分发和商标审查后，才能进入独立 catalog。 +请优先选择上表中与厂商无关的图标；如果kind回退已能表达角色，也可以省略`icon`。经过审查的厂商catalog可通过[显式导入供应商图标包](../guide/provider-icons)使用，而不是随产品附带图像。请阅读并接受各供应商条款，并保留包中每项资源的许可、来源和署名信息。 ## Catalog 与资源安全 From 8e7acc5eb01b2de4b0e4d7765b09d5001907bd98 Mon Sep 17 00:00:00 2001 From: konojunya Date: Sun, 6 Sep 2026 07:39:46 +0900 Subject: [PATCH 2/2] docs: polish Korean provider icon guidance --- content/site/ko/language/themes-and-icons.md | 4 ++-- generated/manifest.json | 2 +- generated/site/ko/language/themes-and-icons.md | 4 ++-- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/content/site/ko/language/themes-and-icons.md b/content/site/ko/language/themes-and-icons.md index fc0b1f9..d17fac8 100644 --- a/content/site/ko/language/themes-and-icons.md +++ b/content/site/ko/language/themes-and-icons.md @@ -51,7 +51,7 @@ diagram "Dark architecture" { | `storage` | `kind-storage` | | `external` | `kind-external` | -공개 코어catalog는`default`, `light`, `dark`에 이 열 개의 의미 기반fallback을 제공하며 벤더 로고를 번들로 포함하지 않습니다. 대부분의 문서는 의미에 맞는`kind`를 선택하고`icon`을 생략하세요. 벤더나 프로젝트 마크가 필요하면 [공급자 아이콘 팩](../guide/provider-icons)을 명시적으로 가져오세요. +공개 코어 카탈로그는 `default`, `light`, `dark`에 이 열 개의 의미 기반 대체 아이콘을 제공하며 벤더 로고를 번들로 포함하지 않습니다. 대부분의 문서는 의미에 맞는 `kind`를 선택하고 `icon`을 생략하세요. 벤더나 프로젝트 마크가 필요하면 [공급자 아이콘 팩](../guide/provider-icons)을 명시적으로 가져오세요. ## 명시적 아이콘 @@ -117,7 +117,7 @@ diagram "Explicit icon" { 코어 catalog에는 현재 `postgresql`, `aws`, `github`, `docker` 같은 벤더 또는 프로젝트 마크가 없습니다. 유효 테마가 작성한 아이콘 식별자를 제공하지 않으면 노드 kind fallback으로 계속 렌더링하고 `STK5001` 경고를 냅니다. -위 표의provider-neutral 아이콘을 사용하거나kind fallback만으로 역할이 명확하면`icon`을 생략하세요. 검토된 벤더catalog는 아트워크 번들이 아닌 [명시적인 공급자 팩 가져오기](../guide/provider-icons)로 사용할 수 있습니다. 각 공급자의 약관을 읽고 동의하고, 가져온 팩에 보존된 에셋별 라이선스·출처·귀속 정보를 준수하세요. +위 표의 공급자 중립적인 아이콘을 사용하거나 `kind`의 대체 아이콘만으로 역할이 명확하면 `icon`을 생략하세요. 검토된 벤더 카탈로그는 아트워크 번들이 아닌 [명시적인 공급자 팩 가져오기](../guide/provider-icons)로 사용할 수 있습니다. 각 공급자의 약관을 읽고 동의하고, 가져온 팩에 보존된 에셋별 라이선스·출처·귀속 정보를 준수하세요. ## Catalog와 에셋 안전성 diff --git a/generated/manifest.json b/generated/manifest.json index 10c08fe..89e5293 100644 --- a/generated/manifest.json +++ b/generated/manifest.json @@ -144,7 +144,7 @@ }, { "path": "site/ko/language/themes-and-icons.md", - "sha256": "c860ae4ae7d9c642461852c97cd29b1971464a2ec5fce4fe2ea71e41cf19c65c" + "sha256": "af84dc459db2cd9fa7b14552cb218874d8e7f418155fb6d876749b76b9cb3bc3" }, { "path": "site/ko/reference/diagnostics-and-limits.md", diff --git a/generated/site/ko/language/themes-and-icons.md b/generated/site/ko/language/themes-and-icons.md index fc0b1f9..d17fac8 100644 --- a/generated/site/ko/language/themes-and-icons.md +++ b/generated/site/ko/language/themes-and-icons.md @@ -51,7 +51,7 @@ diagram "Dark architecture" { | `storage` | `kind-storage` | | `external` | `kind-external` | -공개 코어catalog는`default`, `light`, `dark`에 이 열 개의 의미 기반fallback을 제공하며 벤더 로고를 번들로 포함하지 않습니다. 대부분의 문서는 의미에 맞는`kind`를 선택하고`icon`을 생략하세요. 벤더나 프로젝트 마크가 필요하면 [공급자 아이콘 팩](../guide/provider-icons)을 명시적으로 가져오세요. +공개 코어 카탈로그는 `default`, `light`, `dark`에 이 열 개의 의미 기반 대체 아이콘을 제공하며 벤더 로고를 번들로 포함하지 않습니다. 대부분의 문서는 의미에 맞는 `kind`를 선택하고 `icon`을 생략하세요. 벤더나 프로젝트 마크가 필요하면 [공급자 아이콘 팩](../guide/provider-icons)을 명시적으로 가져오세요. ## 명시적 아이콘 @@ -117,7 +117,7 @@ diagram "Explicit icon" { 코어 catalog에는 현재 `postgresql`, `aws`, `github`, `docker` 같은 벤더 또는 프로젝트 마크가 없습니다. 유효 테마가 작성한 아이콘 식별자를 제공하지 않으면 노드 kind fallback으로 계속 렌더링하고 `STK5001` 경고를 냅니다. -위 표의provider-neutral 아이콘을 사용하거나kind fallback만으로 역할이 명확하면`icon`을 생략하세요. 검토된 벤더catalog는 아트워크 번들이 아닌 [명시적인 공급자 팩 가져오기](../guide/provider-icons)로 사용할 수 있습니다. 각 공급자의 약관을 읽고 동의하고, 가져온 팩에 보존된 에셋별 라이선스·출처·귀속 정보를 준수하세요. +위 표의 공급자 중립적인 아이콘을 사용하거나 `kind`의 대체 아이콘만으로 역할이 명확하면 `icon`을 생략하세요. 검토된 벤더 카탈로그는 아트워크 번들이 아닌 [명시적인 공급자 팩 가져오기](../guide/provider-icons)로 사용할 수 있습니다. 각 공급자의 약관을 읽고 동의하고, 가져온 팩에 보존된 에셋별 라이선스·출처·귀속 정보를 준수하세요. ## Catalog와 에셋 안전성