c# - API ドキュメンテーションと列挙型セマンティクス

Question

REST Web サービスの API ドキュメントを作成しています。リクエストとレスポンスにはいくつかの列挙型が含まれていますが、これらを説明するのに適したセクション タイトルは何でしょうか。「列挙型」というタイトルはプログラミングのように聞こえますが、間違っていますか?

Gender

Male - 1
Female - 2

Pool Team Status

All - 1
Active - 2
Active and Paid - 3

Registration Status

All - 1
Active - 2
Active and Paid - 3

Status

All - 1
Active - 2
Active and Paid - 3

Answer 1

それらをオプション、代替、またはその他の同義語として参照できます（それがそのようなものである場合）。

それにもかかわらず、管理者が経験しなければならないものとしてだけでなく、他のプログラマー向けのドキュメントを書いていると仮定すると、Enumerations または Enums は良いと思います。それは、あなたが達成したいことを聴衆に明確にするからです。