FlavorText documentation is incorrect

src/docs/utility.json の FlavorText レスポンスモデルから始め、そのフィールドを src/docs/contests.json と src/docs/pokemon.json のエンドポイントモデルと比較します。FlavorText から version を削除し、VersionFlavorText を追加して、PokemonSpecies の flavor_text_entries 参照を更新します。ドキュメント化されたスキーマが参照先の API スキーマと一致すれば完了です。

The documentation for the FlavorText type does not match its schema.

All referenced schema are from PokeAPI / api-data in the data/schema/v2 folder.
I have checked that the referenced schemas match the API results (for at least an id of 1).
The examples given in the documentation do match the schemas, so would not need changing.

Issue details

FlavorText is specified as having a version field, when most references to it do not have one.

The FlavorText type is documented as having three fields:

• flavor_text
• language
• version

FlavorText is used in three endpoints (all under the field flavor_text_entries) in the documentation:

• ContestEffect
• SuperContestEffect
• PokemonSpecies

In the contest-effect and super-contest-effect endpoints, the value under flavor_text_entries does not have a version field (ie. it only has flavor_text and language fields).

In the pokemon-species endpoint, the value under flavor_text_entries does have a version field, so matches the online documentation.

Suggestion

Making a new VersionFlavorText type for use in the PokemonSpecies endpoint, and changing the FlavorText type to not have the version field.

The naming of this type would match the pattern of VersionGroupFlavorText type (which has the fields text, language, and version_group).

VersionGroupFlavorText is also only used once (in the item endpoint), so it seems reasonable to add VersionFlavorText in the utility section along with it. Alternatively, it could be added in the Pokemon group under the PokemonSpecies endpoint.

This would affect:

• /src/docs/utility.json
  • Remove version field from the FlavorText type response model (link to line)
  • Add a VersionFlavorText type identical to the current FlavorText type (with flavor_text, language, and version fields) (link to line)
• /src/docs/contests.json
  • Change type of flavor_text_entries field in the PokemonSpecies response model from list of FlavorText to list of VersionFlavorText (link to line)