Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 10 additions & 5 deletions docs/manuals/marketplace/packages.md
Original file line number Diff line number Diff line change
Expand Up @@ -122,17 +122,22 @@ 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,
typically in the source tree. For example, the following is a valid layout for an icon, readme, and release notes:
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 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:
Expand All @@ -142,9 +147,9 @@ up alpha xpkg append --extensions-root=./extensions xpkg.upbound.io/<your accoun
```

:::warning
This is an alpha feature, and requires `up` CLI version `v0.39.0` or later. See
`xpkg append` an alpha feature, and requires `up` CLI version `v0.39.0` or later. See
[`up alpha xpkg append`][up-alpha-xpkg-append] for complete
documentation and conventions.
documentation and conventions.
:::

## Troubleshooting
Expand Down