api-platform / docs

API Platform documentation
https://api-platform.com/docs/
166 stars 1.08k forks source link

feat(schema-generator): add documentation for using Labels for naming resources #1848

Open Angatar opened 11 months ago

Angatar commented 11 months ago

Documentation of NEW FEATURE, for the shema-generator: The schema-generator now has new options that allow to use labels for naming the types/resources of interest instead of reusing the ID part of their URI fragment identifier, which is the default behavior. This option is especially useful when using vocabularies that have adopted numerical IDs, such as Wikidata or OBO ontologies.

CF schema-generator's feature request : #412

Angatar commented 11 months ago

It seems there is currently a lint issue with https://github.com/api-platform/docs/blob/3.2/core/upgrade-guide.md which is not impacted at all by this pull request but this still broke the checks of the current PR:

Line 30 and Line 50 of the /core/upgrade-guide.md have both an additional trailing space that generate an error during lint check. Do I need to integrate the fix of this file in this PR as well?

soyuka commented 11 months ago

https://github.com/api-platform/docs/pull/1852 about your comment, thanks for the json-schema feature we'll take a look at this shortly!

Angatar commented 11 months ago

Thx for #1852 !