И это уже высококвалифицированный конский труд

Я всегда привожу в пример автотрассировку плат. Вроде формально все валидно на выходе и соответствует принципиальной схеме. Но переусложнено, и требует руками перетащить половину узлов, чтобы было нормально

Не всё понял, но выглядит интересно.

​​Great Expectations: Always know what to expect from your data.

Great Expectations helps data teams eliminate pipeline debt, through data testing, documentation, and profiling.

Software developers have long known that testing and documentation are essential for managing complex codebases. Great Expectations brings the same confidence, integrity, and acceleration to data science and data engineering teams.

See Down with Pipeline Debt! for an introduction to the philosophy of pipeline testing: https://medium.com/@expectgreatdata/down-with-pipeline-debt-introducing-great-expectations-862ddc46782a

Key features:
- Expectations or assertions for data. They are the workhorse abstraction in Great Expectations, covering all kinds of common data issues
- Batteries-included data validation
- Tests are docs and docs are tests: many data teams struggle to maintain up-to-date data documentation. Great Expectations solves this problem by rendering Expectations directly into clean, human-readable documentation
- Automated data profiling: wouldn't it be great if your tests could write themselves? Run your data through one of Great Expectations' data profilers and it will automatically generate Expectations and data documentation
- Pluggable and extensible

https://github.com/great-expectations/great_expectations

#python #ds #docops

«Большие надежды», data science version ;)

Это вообще хорошая идея - форсить нормальные описания свойств/инвариантов, будь то в документации или в тестовом покрытии, а потом на основе этих описаний выдавать человекочитаемый текст.

Для QuickCheck и его продолжателей, насколько я знаю, пока такого нет.

Интересный анализ от Netlify. В том числе по генераторам статических сайтов. Больше всего опрошенным понравился 11ty. Кто-то пользовался этим?

Закину и сюда, автоматизация приветствуется

О, я когда-то то же самое спрашивал. Решается поиском по фразе "Описание базы данных"

по чатам

спасибо, пошла в глубины

Добрый вечер.
Выбираю систему для документации пользователя по продукту.
Посоветуйте что сейчас стоит использовать.

Вводные:
- online
- возможно версионность функционала ПО и как следствия разная справка для разных версий ПО. (одни пользователи видят одно другие другое)
- экспорт в pdf

Спасибо.

Asciidoc+git+antora

Большое спасибо. Пойду почитаю про Asciidoc и antora

Sphinx doc тоже удовлетворяет требованиям для pdf придётся добавить latex шаблон или взять дефолтный

Ну и предложу foliant.org, если для маркдауна

Спасибо. Почитаю про все.