Телеграмм чат группы docsascode страница 629

https://skorokithakis.github.io/expounder/ - интересная реализация того, как можно разделять общую и дополнительную информацию (в an example можно посмотреть детальнее как это работает)

источник

18:44пожаловаться #5

IC

Ivan Cheban in DocOps-сообщество

Anna P

https://skorokithakis.github.io/expounder/ - интересная реализация того, как можно разделять общую и дополнительную информацию (в an example можно посмотреть детальнее как это работает)

Классная штука! Хотя во многих случаях старый добрая всплывающая подсказка (tooltip), мне кажется, была бы лучше. Кроме того, этот экспандер, можно было бы доработать, чтобы разворачиваемый кусок текста можно было снова скрывать.

источник

20:33пожаловаться #6

AP

Anna P in DocOps-сообщество

Ivan Cheban

Классная штука! Хотя во многих случаях старый добрая всплывающая подсказка (tooltip), мне кажется, была бы лучше. Кроме того, этот экспандер, можно было бы доработать, чтобы разворачиваемый кусок текста можно было снова скрывать.

Да, я согласна, что это решение далеко не всегда подходит, но все равно достаточно любопытно)

источник

20:34пожаловаться #7

2020 March 25

OK

Oleg Kovalov in DocOps-сообщество

https://buttondown.email/hillelwayne/archive/please-dont-write-your-documentation-in-markdown/

buttondown.email

Please don't write your documentation in Markdown

Please don't write your documentation in Markdown. Please. I'm begging you. Markdown is tolerable for short documentation, like a readme.md. Past that, it's...

источник

11:24пожаловаться #8

СФ

Семён Факторович in DocOps-сообщество

источник

11:29пожаловаться #9

СФ

Семён Факторович in DocOps-сообщество

аж чаем поперхнулся!

источник

11:29пожаловаться #10

СФ

Семён Факторович in DocOps-сообщество

(дальше автор, конечно, пишет, что это шутка)

источник

11:29пожаловаться #11

VS

Vadim Smelyanskiy in DocOps-сообщество

О, нет!

источник

11:30пожаловаться #12

KC

Kseniya Chudakova in DocOps-сообщество

Vadim Smelyanskiy

О, нет!

серьезно?!

источник

11:31пожаловаться #13

VS

Vadim Smelyanskiy in DocOps-сообщество

Kseniya Chudakova

серьезно?!

Увы(

источник

11:31пожаловаться #14

ЕД

Егор Доронин in DocOps-сообщество

Когда микроскопом начинают забивать гвозди, а через молоток пытаются смотреть на звёзды, ещё и не такое случается

источник

11:38пожаловаться #15

ЕД

Егор Доронин in DocOps-сообщество

Лучше бы выпустил статью о том, как грамотно выбрать инструмент по задаче

источник

11:38пожаловаться #16

OK

Oleg Kovalov in DocOps-сообщество

а как вы к документации в Word относитесь?

источник

11:38пожаловаться #17

АП

Андрей Привалов in DocOps-сообщество

Никак) не попадалось. Хотя я пытался в гугл доках сделать

источник

11:39пожаловаться #18

VS

Vadim Smelyanskiy in DocOps-сообщество

Oleg Kovalov

https://buttondown.email/hillelwayne/archive/please-dont-write-your-documentation-in-markdown/

buttondown.email

Please don't write your documentation in Markdown

Please don't write your documentation in Markdown. Please. I'm begging you. Markdown is tolerable for short documentation, like a readme.md. Past that, it's...

Аргумент про семантическую разметку мне близок, но я лично не видел хорошей разметки и на базе предлагаемого RST

Кто-нибудь может поделиться опытом, кто прям размечает в доке данные (например, определения) и с этой разметкой что-то делает?

источник

11:39пожаловаться #19

OK

Oleg Kovalov in DocOps-сообщество

Андрей Привалов

Никак) не попадалось. Хотя я пытался в гугл доках сделать

вот и у нас в гугл доках...

источник

11:40пожаловаться #20