Github user drigodwin commented on a diff in the pull request:
https://github.com/apache/brooklyn-docs/pull/198#discussion_r123556880
--- Diff: guide/blueprints/catalog/bundle.md ---
@@ -5,7 +5,25 @@ layout: website-normal
### Bundling Catalog Resources
-It is possible to add an OSGi bundle to AMP. This is useful when you have
a blueprint that needs to reference external scripts/resources or when you have
multiple blueprints that you want to keep in sync. Brooklyn will persist any
uploaded bundles so that they are available after a restart, or a HA failover.
+It is possible to upload catalog items and associated resources as a
single bundle to AMP.
+This is useful when you have a blueprint that needs to reference external
scripts/resources or
+when you have multiple blueprints that you want to keep in sync. Brooklyn
will persist any
+uploaded bundles so that they are available after a restart or on HA
failover.
+
+The bundle must be a ZIP file including a `catalog.bom` in the root.
+(The `br` CLI will create a ZIP from a local folder, for convenience.)
+The `catalog.bom` must declare a `bundle` identifier and a `version`,
+following Brooklyn's [versioning](versioning.html) rules.
+Brooklyn will keep track of that bundle, allow SNAPSHOT-version bundles to
be replaced,
+and ensure dependent bundles (specified as `brooklyn.libraries` or, for
people familiar
+with OSGi, the `Required-bundle` manifest header) are available for
searching.
--- End diff --
I would probably remove `for searching` as it's not clear what searching is
in this context.
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at [email protected] or file a JIRA ticket
with INFRA.
---
