What makes a good resource description
Before your resource is published in the federation it needs to have a name, logo and description (a sanity check on these is one of the things our service desk looks at when you make your application live). Your marketing folks will have a good idea about how to describe your service in a winning way, but there are some considerations it will help for them to be aware of before supplying you with content:
Logo shape, color, etc.
The logo needs to be at least 128 x 128px, less than 10MB, square, and in png, gif or jpg format. Ideally it will have a transparent background. (While it will usually appear in front of a white background, that is unlikely to always be the case.)
A banner only needs to be added if you are using a discovery service such as Wayfinder and want one to appear when you send users there. It must be at least 400 x 50px and less than 10MB. You do not need to add a banner if you are writing your own discovery service.
Name
This should of course be the name of your service that your customers will recognize.
If you have more than one service behind the same entityID, allow for that in the name / description.
Description
While the full description (up to 1000 characters) is available on a details page and is included in catalog searches, the description that is visible on the cards in the main catalog view will be truncated. Depending on the length of your name, only the first 35 - 70 characters of the description will display there.
It is this card view that is previewed when you set an application as live.
Catalog search
Our mutual customers usually have to search the catalog rather than paging through a small number of resources. Search returns results based on:
Matching on the resource name
Matching on the description
Matching on the entityID
Results will be ranked in that order.