Зачем читать Фихтенгольца и зачем читать комментарии преподавателя к письменной домашке, если на контрольной можно списать решение с телефона? Зачем читать ошибки компилятора и мануалы к языку, если можно скопипастить решение с SO? Создатели того же Rust или Elm уже не знают, как поближе к программисту принести объяснение ошибки, но сдаётся мне, это не сильно изменит ситуацию. /rant mode off.

В ваших словах звучит неуместный снобизм и вы видимо не очень понимаете проблематику ошибок приведения типов в расте

Когда я перешёл с C#/Java, где статическая типизация, на Python с динамической, мне было ооочень больно от того, что среда разработки больше не показывает мне документацию прямо под курсором. Работать с незнакомым API или контрибьютить в незнакомый проект на Java сильно легче: ставишь точку, среда разработки раскрывает тебе список методов с подробной документацией про каждый. Можно настроить отдельную панель, где будет полноэкранная дока про класс или метод, на котором сейчас курсор стоит.

А в Python такого нет. В своём коде я использую опциональную типизацию (mypy-lang.org/), она сильно помогает. И то я постоянно читаю доки в браузере на втором мониторе.

В pycharm таки есть

Так что всё, что приносит доки поближе к «курсору», туда, куда уже направлено внимание разработчика, очень помогает этому разработчику.

Есть, когда он явно знает тип или может его вывести. То есть когда ты только что присвоил переменной явное значение или когда она пришла из метода с объявленным возвращаемым типом.

https://www.jetbrains.com/help/pycharm/documentation-tool-window.html можно заставить сканить внешнюю документацию ещё

А что сейчас есть красивого для статических сайтов? Для митапа хотим собрать простенький лендинг и немножко документации

Кстати, если кому надо что-нибудь подеплоить некоммерческого или коммерческого или небольшого — мы тут обнаружили волшебный https://kintohub.com, который умеет и в серверлесс, и в веб-приложения, и в сборку, и в статику

Gatsby есть, чего же боле.

Подскажите, пожалуйста, какая софтина поможет реализовать следующий use case.
(Простите, если вопрос боянный.)

Несколько dev-команд работает над программным продуктом.
Репозиториев у нас сотни, ибо продукт большой.
Репозитории лежат на GitLab (self-hosted) и на Github.
Технические документы пишутся на markdown и лежат в репах так же, как код. Документы по конкретному сервису лежат именно в его репе.

Хочется:
сделать сайт, на котором централизованно можно почитать всю эту нашу документацию из репозиториев. И чтобы был глобальный поиск по ней.
Есть ли для этого какой-то готовый инструмент?

Аскидоктор и антора

А кто знает хорошие примеры gRPC API? Чтобы и написано понятно было, и читать удобно. Пожалуйста, напишите мне (@Nick_Volynkin) или в чат @docsascode.

а всё, он самый популярный? =)

А для markdown такого не существует?

Тысячи их, staticgen.com

и вот этого тоже тысячи

Таких, чтоб агрегировали документы из разных реп в один сайт?