Size: a a a

DocOps-сообщество

2019 October 03

LR

Liubov Riazanova in DocOps-сообщество
Спасибо!
источник
2019 October 04

NK

ID:0 in DocOps-сообщество
​​R Markdown: The Definitive Guide

Всего неделю назад вышла новая книга про R Markdown. Казалось бы, зачем миру ещё одна реализация Markdown?

Во-первых, в R Markdown всё очень хорошо с выходными форматами: HTML, PDF, DOCX, четыре разных формата слайдов. Приятно иметь это всё сразу и не собирать цепочку из нескольких инструментов.

Во-вторых, есть выполняемые блоки кода, которые рисуют диаграммы и любой другой контент в документе. Код можно писать на R, Python, Julia, C++, С, SQL, Fortran и других языках. Я пока не успел попробовать, но выглядит это гораздо мощнее, чем обычные языки шаблонизации вроде Jinja и Liquid. Конечно, можно к любому SSG написать своё расширение, которое будет делать что угодно при сборке документа, но тут-то не нужны расширения.

Я думаю, это очень крутая фича. Она открывает путь к автодокументированию в принципе любых данных, которые вы можете собрать программно.

В-третьих, в R Markdown есть режим R Notebook — когда блоки кода на R выполняются интерактивно. Вроде бы можно переиспользовать один документ с разными источниками данных.  Если вы знакомы с Jupyter Notebook — это примерно оно же, только на R.

А ещё в комплекте с R Markdown есть сервис Bookdown — инструмент для написания и публикации чего угодно на R Markdown. На нём уже написана куча книг по языку R. Конечно, на нём же сделана книга-документация по R Markodwn и ещё одна книга про сам сервис Bookdown.

В общем, это не просто 101й парсер, а целая развитая экосистема. Стоит попробовать, особенно если ваша работа связана с обработкой данных.

На скриншоте — документ R Markdown и собираемая из него интерактивная страница с визуализацией данных (источник).
источник

NK

ID:0 in DocOps-сообщество
R Markdown настолько хорош, что попал под блокировку :)
https://t.me/zatelecom/11815
источник

DB

Dima Boger in DocOps-сообщество
Кстати, я тут посматриваю на фронтенд и у них там всё более чем сексуально:
https://storybook.js.org/use-cases/
https://medium.com/storybookjs/storybook-5-2-794958b9b111
источник

DB

Dima Boger in DocOps-сообщество
Любой компонент фронтенда (начиная кнопкой и заканчивая полноценным блоком страницы) становится элементом дизайн-системы, получает разные состояния и описывается "историями", по сути — сценариями использования
источник

DB

Dima Boger in DocOps-сообщество
А ещё вокруг него выстраивается смелый сандбокс, где можно подёргать входные параметры для компонента и понять как он себя ведёт в зависимости от них
источник

DB

Dima Boger in DocOps-сообщество
источник

NV

Nick Volynkin in DocOps-сообщество
Вроде бы так уже можно в Figma
источник

DB

Dima Boger in DocOps-сообщество
Тут фича в том, что компонент в сторибуке — это настоящий компонент из продакшена
источник

NV

Nick Volynkin in DocOps-сообщество
да, я понимаю
источник

NV

Nick Volynkin in DocOps-сообщество
у нас так в документации на UI-библиотеку вставлены реальные React-компоненты
источник

NV

Nick Volynkin in DocOps-сообщество
источник

DB

Dima Boger in DocOps-сообщество
Работаю с этим инструментом иногда, и это просто счастье: оно по-настоящему интерактивное, видно как ведёт себя компонент, какие параметры принимает и какие экшены и действия производит
источник

DB

Dima Boger in DocOps-сообщество
styleguidist?
источник

NV

Nick Volynkin in DocOps-сообщество
Dima Boger
styleguidist?
источник

DB

Dima Boger in DocOps-сообщество
вот я теперь топлю за сторибук из-за скорости его развития 🌚
источник

NV

Nick Volynkin in DocOps-сообщество
@Fznamznon добро пожаловать во все чаты сразу :)
источник

NV

Nick Volynkin in DocOps-сообщество
Где-то есть исчерпывающий список техписательских чатов?
источник

L

Lili Marlene in DocOps-сообщество
Nick Volynkin
@Fznamznon добро пожаловать во все чаты сразу :)
источник

L

Lili Marlene in DocOps-сообщество
Nick Volynkin
Где-то есть исчерпывающий список техписательских чатов?
Не уверена. Перечисленные выше выложили в чате аналитиков
источник