Hubs provide their own authentication token. You can deploy an existing hub documentation using either its own authentication token, or the hub one.
bump deploy your/doc.yml --doc my-doc --hub hub-slug-or-id --token my-doc-tokenbump deploy your/doc.yml --doc my-doc --hub hub-slug-or-id --token hub-token
You can define default settings at the hub level. These settings will be then used by the hub's documentations. You can define:
logo
color scheme
grouping strategy (group by tag or by path)
navigation mode (1 or 2 levels navigation)
The default settings can be overridden at the documentation level by selecting specific values in the documentation settings tab.
You can display hub's documentations grouped by tag instead of a global list. Select "Group documentations by tag" in your hub's UI settings, and fill tags for each documentation.
You can add multiple tags to a documentation. It will be displayed under each associated tag on the hub.
You can create a documentation on the fly by using the --auto-create
option: when deploying, if the documentation doesn't already exist, a new one will be created with your hub defaults, and the given slug (--doc
) and name (--doc-name
).
bump deploy your/doc.yml --auto-create --doc my-doc --hub hub-slug-or-id --token hub-token
In this case, you have to provide the following parameters:
--auto-create
: activate the auto-creation mode
--doc
: the documentation slug (url) you want to use
--doc-name
(optional) : the documentation name you want to use. Automatically generated from documentation's slug if missing.
--hub
: the hub slug (or id)
--token
: the hub token