From cf440edd12c61639f2d9aac283b459ac90cd3628 Mon Sep 17 00:00:00 2001 From: Jason Tang Date: Mon, 22 Dec 2025 11:38:03 -0500 Subject: [PATCH 1/2] include additional documentation as a valid extension. Signed-off-by: Jason Tang --- docs/manuals/marketplace/packages.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/manuals/marketplace/packages.md b/docs/manuals/marketplace/packages.md index 61356f6ca..92d7dff05 100644 --- a/docs/manuals/marketplace/packages.md +++ b/docs/manuals/marketplace/packages.md @@ -122,7 +122,8 @@ publishing a public Marketplace listing page. Users may also provide their additive package content, which renders on the listing page for that package version. -The Marketplace currently supports optionally adding an icon, release notes, readme, and SBOMs. By convention, organize these files in a directory-of-directories hierarchy, +The Marketplace currently supports optionally adding an icon, release notes, readme, additional documentation, and SBOMs. +By convention, organize these files in a directory-of-directories hierarchy, typically in the source tree. For example, the following is a valid layout for an icon, readme, and release notes: ```text @@ -142,9 +143,9 @@ up alpha xpkg append --extensions-root=./extensions xpkg.upbound.io/ Date: Mon, 22 Dec 2025 13:37:56 -0500 Subject: [PATCH 2/2] update example Signed-off-by: Jason Tang --- docs/manuals/marketplace/packages.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/manuals/marketplace/packages.md b/docs/manuals/marketplace/packages.md index 92d7dff05..477640159 100644 --- a/docs/manuals/marketplace/packages.md +++ b/docs/manuals/marketplace/packages.md @@ -124,16 +124,20 @@ Users may also provide their additive package content, which renders on the list The Marketplace currently supports optionally adding an icon, release notes, readme, additional documentation, and SBOMs. By convention, organize these files in a directory-of-directories hierarchy, -typically in the source tree. For example, the following is a valid layout for an icon, readme, and release notes: +typically in the source tree. For example, the following is a valid layout for each supported extension: ```text extensions +├── docs +│ └── developing.md ├── icons │ └── icon.svg ├── readme │ └── readme.md └── release-notes - └── release_notes.md +│ └── release_notes.md +├── sbom +│ └── sbom.spdx.json ``` Then, to add these assets to your package version, use the `up` CLI: