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:
spec: owner: kind: Group namespace: default name: finance:international/legal
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.