На нём документирован Докер https://docs.docker.com/engine/api/v1.37/#operation/Session

На самом деле это все ещё сваггер (опенапи спек)

Ну да

Здравствуйте, только не стукайте. Вот смотрите, сборник требований для оформления кода - это кодстайл.
Вопрос: А как правильно назвать сборник всех нотисов от проекта для программистов по поводу написания самого кода?  Ну, которые указывают, что "если делаешь А, то делай и Б". На бизнес-процессы и прочее не тянет, ибо тут вопрос не "делай что", а "делай как", это всё внутреннее. Как называть такое правильно? Гайдлайном обозвать?

Я за гайдлайн

Или стайлгайд

да

но я лелею надежду найти хотя бы один контрпример:)

ясно, спасибо

у нас это называется "best practices"

Coding guideline у нас

Перепутал. Manual of style это про тексты. А у вас это похоже на сборник лучших практик, + к Игорю.

Поверьте моему горькому опыту с гитбуком - берите сваггер и не выпендривайтесь. Мы смигрировали описания на опенапи 3.0, прикрутили авторизацию и дали ссылку на эту доку из гитбука. И тестируй запросы, сколько влезет.
Гитбук позволяет импортировать локальные файлы или из репозитория, но, там он тянет все сразу, кусками нельзя (здесь невероятно тащит asciidoctor).
Простого решения, чтобы впихнуть всегда актуальный рест в гитбук, нет. Я сам задавался вопросом, чтобы засинкать API с докой, но, пока все туманно.
Насчёт redoc - он крутой, но, в нем нет возможности отправки запросов. И это не формат документирования (как там писали про докер), это просто оболочка для swagger/openapi спек. Визуально, пожалуй, самая крутая оболочка

👍

Если бы не куча переменных, которые у нас юзаются в гитбуке, я бы уже давно смигрировал доки во vuepress

очень исчерпывающе, спасибо!

Coding rules. Еще можно SonarCube подключить, что б проверял.

Ого, SonarCube настолько продвинутый что ему можно скормить набор пожеланий к коду и он будет за этим следить? А как описываются основные антипаттерны?

Умеет например найти три похожых куска кода и предложить зарефакторить, по Фаулеру чтоб прям всё?

Это IDEA умеет вроде бы )