Сложно представить, чтобы документация и код НАСТОЛЬКО не соответствовали друг другу, если только она не устарела вхлам, отстав на несколько лет от активного меняющегося кода. Скорее, боль заключается в том, что единый (ubiquitous) язык не применяется совсем - ни в коде, ни в документации.
Не является ли проблемой с точки зрения Единого Языка, что у вас в каталоге AssignProductToTemplate/ используется три разных глагола (Assign, Move, Changed)?
Как будто бы вложенные файлы должны быть AssignProductToTemplate.php и ProductTemplateAssigned.php
OpenAPI — это открытая спецификация для описания REST API.
Ну не только REST API. Как будто в мире есть только рест, и любой апи на протоколе хттп является рестом...
OpenAPI прекрасно подходит и для не-RESTful API, например, для RPC HTTP API или Action-oriented (оно же Operation-centric) HTTP API. Читал, что в версии 4.0 собираются даже поддержку gRPC и асинхронщины прикрутить.
Нет никаких проблем описать в опенапи эндпоинт типа /doSomethingStrange. REST тут не при чем.
В остальном спасибо, конечно, но непонятно, к чему и почему это "пошаговое руководство". Просто краткий пересказ общедоступной спеки.
Как реализовано редактирование таблицы, если API поддерживает только Read, Create, Delete, без Update? Или в таблице с API забыли указать соответствующий эндпоинт?
Почему до 32 лет, а не до 30?
Каким образом тут может получиться 11 ?
Сложно представить, чтобы документация и код НАСТОЛЬКО не соответствовали друг другу, если только она не устарела вхлам, отстав на несколько лет от активного меняющегося кода. Скорее, боль заключается в том, что единый (ubiquitous) язык не применяется совсем - ни в коде, ни в документации.
дгуг дгуга!
Gemeni -> Gemini.
Ошибаетесь. Никакой нормальной оппозиции в 90х не было.
По-настоящему нормальная оппозиция появилась в 2010-х и далее, но ее лидера, как недавно выяснилось, убили ядом лягушки.
А где они сравниваются в таблице? Вроде нет такого в статье.
А в чем тогда много смысла?
бекон
Это как?!?
О чем здесь речь?
У вас в слово ambiguity лишняя буква l затесалась.
Ну там же речь о радиаторе воображаемого автобуса.
Не является ли проблемой с точки зрения Единого Языка, что у вас в каталоге AssignProductToTemplate/ используется три разных глагола (Assign, Move, Changed)?
Как будто бы вложенные файлы должны быть AssignProductToTemplate.php и ProductTemplateAssigned.php
Имею вопрос.
Как в предложенной файловой структуре понять, что Product - основной домен, а Template - поддерживающий?
Это не вопрос вкуса, а вопрос приверженности подходу DDD. Ознакомьтесь с ним хотя бы базово ;)
Ну не только REST API. Как будто в мире есть только рест, и любой апи на протоколе хттп является рестом...
OpenAPI прекрасно подходит и для не-RESTful API, например, для RPC HTTP API или Action-oriented (оно же Operation-centric) HTTP API. Читал, что в версии 4.0 собираются даже поддержку gRPC и асинхронщины прикрутить.
Нет никаких проблем описать в опенапи эндпоинт типа /doSomethingStrange. REST тут не при чем.
В остальном спасибо, конечно, но непонятно, к чему и почему это "пошаговое руководство". Просто краткий пересказ общедоступной спеки.
Да и для не-RESTful тоже.
Добрый день!
Я из Тольятти, со сборочного цеха №3 АвтоВАЗа. У нас тут эту дрель до сих пор ищут.
Вы не могли бы ее вернуть, пожалуйста?
Как реализовано редактирование таблицы, если API поддерживает только Read, Create, Delete, без Update? Или в таблице с API забыли указать соответствующий эндпоинт?