Project: Artifact Hub (App Definition and Development / Application Definition & Image Build)
File: krew_annotations.md

Artifact Hub uses some data from the `plugin's manifest file` to populate the information for a package of kind Krew. Usually most of the information needed is already there, so there is no extra work required by maintainers to list their plugins on Artifact Hub. However, sometimes there might be cases in which it may be useful to provide some more context that helps improving users' experience in Artifact Hub. This can be done using some special annotations in the file. artifacthub.io/category (string, see example below) This annotation allows publishers to provide the package's category. Please use only one category from the following list: `ai-machine-learning`, `database`, `integration-delivery`, `monitoring-logging`, `networking`, `security`, `storage` or `streaming-messaging`. When a category is not provided, Artifact Hub will try to predict one from the package's keywords by using a machine learning-based model. If you notice that the prediction isn't correct, we really appreciate that you submit the correct category as it helps us to train and improve the model. In the case that the prediction isn't correct but your package doesn't fit well in any of the categories supported, you can use the special value `skip-prediction` in the category field to prevent an incorrect classification. artifacthub.io/changes (yaml string, see example below) This annotation is used to provide some details about the changes introduced by a given task version. Artifact Hub can generate and display a ChangeLog based on the entries in the `changes` field in all your plugin versions. You can see an example of how the changelog would look like in the Artifact Hub UI . This annotation can be provided using two different formats: using a plain list of strings with the description of the change or using a list of objects with some extra structured information (see example below). Please feel free to use the one that better suits your needs. The UI experience will be slightly different depending on the choice. When using the list of objects option the valid supported kinds are added, changed, deprecated, removed, fixed and security. artifacthub.io/displayName (string) This annotation allows providing a nicely formatted name for the package. artifacthub.io/keywords (yaml string, see example below) Use this annotation to provide a list of keywords that are relevant to your

Keywords may improve the visibility of your package, making it appear in search results and in the related packages section. By default, the `kubernetes`, `kubectl` and `plugin` keywords are added to packages of Krew kind. artifacthub.io/license (string) Use this annotation to indicate the plugin's license. It must be a valid . artifacthub.io/links (yaml string, see example below) This annotation allows including named links, which will be rendered nicely in Artifact Hub. Some links names have a special meaning for Artifact Hub: support: when a link named support is provided, a link to report an issue will be displayed highlighted on the package view. artifacthub.io/maintainers (yaml string, see example below) Use this annotation to list the maintainers of this package. Please note that the `email` field is required and entries that do not contain it will be silently ignored. artifacthub.io/provider (string) Use this annotation to indicate the name of the organization or user providing this plugin. This may be useful for repositories where plugins are provided by a different entity than the one publishing them in Artifact Hub. artifacthub.io/readme (string) Each package in Artifact Hub is expected to provide a `readme` file that is rendered in the package view of the UI. By default, the content of the `spec.description` field in the file is used as the readme file. This annotation allows providing an Artifact Hub specific readme file in markdown format. artifacthub.io/recommendations (yaml string, see example below) This annotation allows recommending other related packages. Recommended packages will be featured in the package detail view in Artifact Hub. artifacthub.io/screenshots (yaml string, see example below) This annotation can be used to provide some screenshots that will be featured in the package detail view in Artifact Hub. Artifact Hub annotations in `plugin manifest` file: ```yaml metadata: annotations: artifacthub.io/category: security artifacthub.io/changes: | Added cool feature Fixed minor bug artifacthub.io/changes: | kind: added description: Cool feature links: name: GitHub Issue url: https://github.com/issue-url name: GitHub PR url: https://github.com/pr-url kind: fixed description: Minor bug links: name: GitHub Issue url: https://github.com/issue-url artifacthub.io/displayName: My plugin artifacthub.io/keywords: | networking security artifacthub.io/license: Apache-2.0 artifacthub.io/links: | name: link1 url: https://link1.url name: link2 url: https://link2.url artifacthub.io/maintainers: | name: user1 email: user1@email.com name: user2 email: user2@email.com artifacthub.io/provider: Some organization artifacthub.io/readme: | Content added here will be displayed when the package's view in the UI. artifacthub.io/recommendations: | url: https://artifacthub.io/packages/helm/artifact-hub/artifact-hub url: https://artifacthub.io/packages/helm/prometheus-community/kube-prometheus-stack artifacthub.io/screenshots: | title: Sample screenshot 1 url: https://example.com/screenshot1.jpg title: Sample screenshot 2 url: https://example.com/screenshot2.jpg spec: ... ```