реклама
разместить

КАК Я РАЗБИРАЛСЯ С DIPLODOC

Это платформа для создания технической документации в концепции Docs as Сode с открытым исходным кодом.

КАК Я РАЗБИРАЛСЯ С DIPLODOC

Разбирался и продолжаю разбираться как в личных целях, так и для MarketDB, так как нынешняя документация откровенно не очень.

Узнал об этом сервисе на (Не)Конференции от Яндекса, где директор платформы Diplodoc презентовал возможности продукта. Кстати, все доки Яндекса написаны с помощью этого сервиса.

Так вот, лектор рассказывал, как просто, легко и удобно у них делать доку, что они придерживаются популярных принципов построения кода: KISS, DRY и т.д.

Только есть забавный момент. У разработчиков сервиса для легкого написания документации местами не очень понятная или неполноценная документация, такая вот боль, ирония и правда.

Не буду нагнетать, в целом все нормально, уверен разобраться можно. Документация Yandex.Cloud выглядит супер приятно и все это с помощью сервиса Diplodoc. Дополнительно стоит овладеть знаниями CSS и, возможно, JS, хотя, как утверждают разработчики сервиса, обойтись можно и без этих знаний.

А пока что можете посмотреть, что у меня получается: https://github.com/TrueDranik/diplodoc-example.

(То, что на скрине почему-то не работает, как должно, хотя написано согласно документации)

реклама
разместить
Начать дискуссию
Yandex b2b Tech начала тестировать платформу для совместной разработки SourceCraft

Доступ бесплатный, но нужно подать заявку.

1616
22
22
11
реклама
разместить
Как сделать сайт с бэкендом и админкой: Только AI и никакого кода
Как сделать сайт с бэкендом и админкой: Только AI и никакого кода
11
Как внести изменения в патент – заявление и этапы процедуры
Людмила Лисовская
Руководитель патентного отдела "Зуйков и партнеры", патентный поверенный
11
Как помочь бизнесу адаптировать более 300 000 сотрудников и снизить текучесть кадров

Edstein разрабатывает систему для адаптации, оценки и обучения персонала. СЕО и основатель компании Евгений Обогоров рассказывает, как за семь лет система помогла сотням тысяч сотрудников освоиться на рабочем месте в таких крупных компаниях, как Лемана ПРО и СДЭК.

Как помочь бизнесу адаптировать более 300 000 сотрудников и снизить текучесть кадров
11
Как мы упростили анализ встреч и превратили их в инсайты
Как мы упростили анализ встреч и превратили их в инсайты

Для любой компании, предоставляющей цифровые сервисы, онбординг — это ключевой этап взаимодействия с клиентами. Именно в этот момент пользователь знакомится с платформой и формирует своё первое впечатление. У нас в компании важнейшей частью онбординга является демо-встреча.

22
Документы со встроенной YandexGPT. Продвижение сайтов по информационным запросам. Поиск технического мусора. Вкладки в Google выдаче.
Документы со встроенной YandexGPT. Продвижение сайтов по информационным запросам. Поиск технического мусора. Вкладки в Google выдаче.
1010
Как анализировать статистику вашего Telegram-канала?

Почему одни Telegram-каналы стремительно растут, а другие остаются незамеченными? Ответ кроется в аналитике! Понимание статистики — ключ к успешному взаимодействию с аудиторией. В этом посте мы раскроем секреты, как с помощью анализа данных улучшить контент и привлечь подписчиков.

Как анализировать статистику вашего Telegram-канала?
Как влюбиться в китайца или где хранить фрагменты кода?

Я верстаю письма в html и всегда пытаюсь улучшить способы и скорость работы. Задача была найти сервис для быстрого создания, хранения и редактирования фрагментов кода и удобного поиска. Периодически ко мне возвращаются мои старые заказчики (здоровья им и процветания 🫶 ) и мне нужно быстро найти шаблон их проекта и отредактировать, поэтому своя биб…

88
[]