As someone whose mother tongue is not English, I'm sometimes having a hard time having the correct feeling towards the meaning of some words. This is one of those situations.
I'm looking for a term that refers to how an API (an application programming interface) is designed. For example imagine a piece of text with such statements:
- For every
*_new
function, there is a*_delete
function.- All functions creating shared objects take a
name
parameter as the first argument.- All
int *error
arguments used for returning error code are optional and come last in the argument list.
How do you refer to the text containing these statements? For example, is it the style definition of the API? Are these the conventions of the API?
error
argument comes last and is optional" isn't really a "naming" convention.