Бонус: https://github.com/YousefED/typescript-json-schema

https://github.com/Kotlin/dukat

https://github.com/quicktype/quicktype

[microsoft/tsdoc: A doc comment standard for the TypeScript language](https://github.com/microsoft/tsdoc)

> TSDoc is a proposal to standardize the doc comments used in [TypeScript](http://www.typescriptlang.org/) source files.

Как я понял - этот стандарт хорош для тех, кто пишет на TypeScript?
Остальные продолжают использовать PlantUML ?

TypeScript – в т.ч. про документацию форматов данных.

JSON, это всё ещё JavaScript Object Notation, а в TypeScript'е придумали конструкции для их строгой типизации

Не знаю, было ли тут это уже, но мне тут внезапно понадобилось сделать майндмапку, и на глаза попался очень тематичный для канала инструмент:
https://markmap.js.org/repl
Есть в вебе, CLI и VSCode.

http://supermodel.io — вот эта штука выглядит очень приятно. Они даже вроде обещают в ближайшем будущем on-premise-решение.

кто нить знает какие онлайн линтеры для статических сайтов? сходила сюда, а он завис при проверке

http://doculint.io/

А что именно проверять?

SEO, быстродействие?

ссылки хотя бы)

и это тоже неплохо было бы

дисклеймер: я работаю в semrush, и могу быть необъективен

мне нравится семрашевский Site Audit: https://semrush.com/siteaudit/

спасибо! попробую

он прям много чего проверяет

Привет всем, кто сегодня присоединился. Расскажите о себе: чем занимаетесь, что вам интересно про документацию?

(Я временно в отпуске, но тут и без меня есть кому разговор поддержать)

Привет!

Это коллеги из чата аналитиков СПб и Архитекторов IT.

лично у меня часто возникают вопросы по документированию из-за чего свой интерес к этой теме есть.
Также мне важно оставаться информированными и видеть рекомендации и внедрения автоматизированной документации.

Так-то я системный аналитик из Veeam.

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

Лично у меня пока заходит только сваггер для описания боевых АПИ. Всё остальное ручками в Confluence и JIRA.
Надеюсь смогу почерпнуть для себя новые варианты.

Я только спросить, посмотреть зашел.
Вообще Backend разработчик сейчас на Golang, раньше на PHP.
Есть понимание что автоматизированная документация - это хорошо, нужно и правильно. Но по факту ее все равно нужно писать руками (пускай и рядом с кодом) - иной раз хочется вынести все эти аннотации в отдельный структурированный файл и пусть из него конфетка рисуется.
В свое время для пет проекта OpenAPI генерил и искал сервисы/либы, которые по сгенерированной спеке натравят тесты на API (как примеры с example значениями, так и легкий fuzzing). Чтобы была гарантия, что дока высоковероятно отражает работу кода.
Идея - генерить код по спеке все еще в стадии отрицания.
Так что я бы посмотрел канальчик, посмотрел что модно нынче)

> генерить код по спеке все еще в стадии отрицания

зря =) В 2005-м я пилил код на C++, который генерировался из Corba IDL (предтеча протобуфа и gRPC)

Сколько лет после этого код проработал в продакшене? Как часто вносились изменения?