The basic unit of information within the Devhub is a Resource. All resources are represented within the ui as a card. This spec outlines the minimum required metadata for a resource to be represented as a card.
As a note, all of this metadata should be made available as a node field.
The title of the card
The summary of the card (keep this to 140 characters or less for best results)
This is the page path fragment for a resource. Resources can be linked to topics and so this fragment in conjunction with a topic slug makes a full path. Alternatively, a resource can be standalone in which case the slug is used as the full path to a template page.
Path to an external image url
One of the resource types enum
A set of resources this resource is relevant for, currently supported personas are
- Developer
- Designer
- Product Owner
A list of strings that are organized in key value pairs. There may be a set of reserved key value pairs to trigger UI/UX effects in the future.
Labels will be validated in the future and ignored if they do not meet the spec. A well formed label looks like
label=value or movie=starwars episode 4
A list of strings that are added to the search index for this resource. These can also be thought as 'keywords'