message: Clarify that consumesApi and providesApi are two different relationships
  This follows the implementation in
diff: @@ -45,17 +45,28 @@ entity, but there will always be one ultimate owner.
  This relation is commonly generated based on `spec.owner` of the owned entity,
  where present.
  -### `consumesApi` and `providesApi`
  +### `providesApi` and `apiProvidedBy`
  A relation with an [API](descriptor-format.md#kind-api) entity, typically from a
  [Component](descriptor-format.md#kind-component) or
  [System](descriptor-format.md#kind-system).
  -These relations express that a component or system either exposes an API -
  -meaning that it hosts callable endpoints from which you can consume that API -
  -or that they are dependent on being able to consume that API.
  +These relations express that a component or system exposes an API - meaning that
  +it hosts callable endpoints from which you can consume that API.
  -This relation is commonly generated based on `spec.implementsApis` of the
  +This relation is commonly generated based on `spec.providesApis` of the
  +component or system in question.
  +
  +### `consumesApi` and `apiConsumedBy`
  +
  +A relation with an [API](descriptor-format.md#kind-api) entity, typically from a
  +[Component](descriptor-format.md#kind-component) or
  +[System](descriptor-format.md#kind-system).
  +
  +These relations express that a component or system consumes an API - meaning
  +that it depends on endpoints of the API.
  +
  +This relation is commonly generated based on `spec.consumesApis` of the
  component or system in question.
  ### `dependsOn` and `dependencyOf`
  