Содержимое
В общем, как видите, тема неочевидная, и лучше в проекте договориться на старте (или в рамках всей организации), чтобы не получилось у одних так, а у других эдак. Одинаковые вещи должны выглядеть одинаково, это дает возможность предположить и угадать, а не бегать каждый раз в документацию. Документ, в котором описываются эти принципы, называется "Соглашение об именовании". Программистам с этим проще — у них есть линтеры, которые проверяют исходный код на соответствие установленному стилю. Для спецификаций я такого пока не видел. Но хотя бы договориться об этом стоит. Ссылки на стили наименования, сборники лучших практик и посты по этому поводу: https://github.com/RootSoft/Database-Naming-Convention https://dev.to/ovid/database-naming-standards-2061 https://www.belgif.be/specification/rest/api-guide/#resource-archetypes https://restfulapi.net/resource-naming/