Ownership of an entity should be a single reference to a person or team primarily responsible for that entity.
The kind and namespace are both optional and default to the kind of the entity itself, and the
Compound entity refs can be specified if special characters are in any of the three references like so:
Code Owners is an approach to defining ownership of a repository or section of code by using a file that lives alongside that code.
CODEOWNERS file can be used by Roadie Backstage to decorate ownership automatically on entities rather than manually defining ownership in the entity spec definition. This is achieved through the CodeOwnersProcessor in Backstage.
This approach to defining ownership of an entity in Backstage is preferable only if your CODEOWNERS file is kept up to date and is accurate. Otherwise it may be better to define ownership in the entity definition so users can know where to go to update it. Codeowners decoration is opaque in Backstage currently, so it may be difficult to know where the source of an Entity’s ownership is coming from unless you are aware of the CODEOWNERS file.
Roadie will attempt to use a value from the CODEOWNERS file if an entity doesn’t have an owner field with a value or the value is an empty string. If you want to force the usage of a CODEOWNERS file even if an entity already has an owner defined, you can add an annotation
roadie.io/use-codeowners with a value
true to the entity and it will always default to use the CODEOWNERS file.