Skip to content

Commit

Permalink
Update meta-information.adoc
Browse files Browse the repository at this point in the history
Make it clear to not copy an API-ID.
  • Loading branch information
ePaul authored Aug 2, 2023
1 parent 873f34f commit d62446b
Showing 1 changed file with 5 additions and 2 deletions.
7 changes: 5 additions & 2 deletions chapters/meta-information.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -88,8 +88,11 @@ API publishing date>> as order criteria you get the *version* or
*publication history* as a sequence of API specifications.

*Note*: While it is nice to use human readable API identifiers based on
self-managed URNs, it is recommend to stick to UUIDs to relief API designers
from any urge of changing the API identifier while evolving the API. Example:
self-managed URNs, it is recommend to stick to a UUID (freshly generated when
first creating the API) to relief API designers from any urge of changing
the API identifier while evolving the API. *Do not copy the API-ID from another API!*

Example:

[source,yaml]
----
Expand Down

0 comments on commit d62446b

Please sign in to comment.