Dear colleagues,
I'm sure, that this topic was discussed right after the first examples have appeared in Swagger definitions, but I can't find it neither in the Discussions list, nor in the Library.
I see a lot of the pattern "<entity>_Create, <entity>_Update" usage in 4.0.0 API swagger specifications​, then it is needed to change a base entity.
For example, in TMF622 (ProductOrder) the definitions ProductOrder_Create and ProductOrder_Update are used together with ProductOrder.
The idea itself is very sensible, the questions arise about the chosen template.
1. The delimited: why not to use
<entity>Create or
<entity>-create patterns?
2. Operation name: why Create/Update and not Add/Modify?
3. Are there any other actions? E.g.,
<entity>_Validate.
I didn't find the naming rules in TMF630 Guideline. Is there any official guide for this naming, or it's just are "unwritten customs and traditions"?
Best Regards,
------------------------------
Petr Kolotushkin
Netcracker Technology
------------------------------