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

Nick Volynkin in DocOps-сообщество

10:49пожаловаться #1

NV

Bogdan (SirEdvin) Gladyshev

Например, вот такие вопросы на мой взгляд, довольно странные "В какой период времени появилась большая часть из перечисленных стандартов:
AsciiDoc, DocBook, DITA, Markdown, reStructuredText?"

Начало 2000х или даже конец 1990х

Stas Rychkov in DocOps-сообщество

10:50пожаловаться #2

SR

Bogdan (SirEdvin) Gladyshev

Например, вот такие вопросы на мой взгляд, довольно странные "В какой период времени появилась большая часть из перечисленных стандартов:
AsciiDoc, DocBook, DITA, Markdown, reStructuredText?"

В самый лучший период! У MSFT тогда был вечный вопрос лозунгом: Where do you want to go? 🙂

10:54пожаловаться #3

NP

на самом деле 2000-2005: все, кроме Docbook, который появился в 1991

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

NP

vladimir

судя по количеству документации и "быстрый старт" на русском языке - у меня такое чувство, что все еще только начинается 😁

будем надеятся, что на вопрос о массовом внедрении указанных стандартов в России, ответ будет (видоизмененная цитата @Nick_Volynkin) "начало 2020х или даже конец 2010х"

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

AR

зачем вообще надо знать когда появились те или иные стандарты?)

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

AR

вот еслиб было больше вопросов таких же как №4 было бы гораздо полезнее, заодно практика

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

NP

В грамматике он силен. Я думаю, не меньше и в истории.)

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

NP

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

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

AR

для общего развития может и полезно знать, но это дополнительное знание все-таки, в жизни оно никак не пригодится

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

v

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

Nikolaj Potashnikov

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

Выберите правильную команду перевода из md в pdf
а) pandoc -o "*.md" "*.pdf"
б) pandoc -o "*.pdf" "*.md"

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

NP

)))) сугубу практический вопрос, на который я постоянно налетаю и делаю неправильно

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

v

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

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

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

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

СФ

Anna Ryutina

для общего развития может и полезно знать, но это дополнительное знание все-таки, в жизни оно никак не пригодится

не относитесь к тесту слишком серьезно:) это была такая fun activity для конференционного стенда, все эти вопросы нужны были скорее как приглашение к разговору

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

NP

Anna Ryutina

для общего развития может и полезно знать, но это дополнительное знание все-таки, в жизни оно никак не пригодится

многие из этих стандартов, особенно в части wiki-like markup'ов, еще развиваются... и для понимания того, что с ними будет, часто необходимо понимать, почему они такие

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

AR

Nikolaj Potashnikov

многие из этих стандартов, особенно в части wiki-like markup'ов, еще развиваются... и для понимания того, что с ними будет, часто необходимо понимать, почему они такие

я больше люблю практические задания, а историю запоминать это скучно))

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

NP

Семён Факторович

не относитесь к тесту слишком серьезно:) это была такая fun activity для конференционного стенда, все эти вопросы нужны были скорее как приглашение к разговору

и в части истории: было важно, чтобы люди понимали, что это не что-то новое, а уже существует довольно давно. Для многих все это были новые слова

👨🏿‍💻 Технический писатель 👨🏿‍💻

Кто знает, что за профессия такая "Технический писатель"? Вообще кто-нибудь слышал о ней?

🤔 Кто это.

Как гласит Wikipedia:
Технический писатель — специалист, занимающийся документированием в рамках решения технических задач, в частности разработки программного обеспечения.

Основная задача технического писателя — написание документа, который бы удовлетворял определённым требованиям. Требования могут определяться как нормативными актами, существующими в отрасли применения продукта, так и различными целями, которые организация-разработчик ставит перед собой.

В Вики как всегда все "грамотно" и нихрена не понятно.

Если по-простому, то тех писатель составляет инструкции "как пользоваться [программой/API/сайтом/этой вибрирующей штукой/и тд]" в виде, понятном даже твоей бабушке.

Например, раньше вы читали инструкции к новому чайнику или стиральной машине. Теперь это уже мало кто делает, но инструкции все же прикладывают.

В мире айтишки распространены гайды по использованию API,…

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

NK

ID:0 in DocOps-сообщество

Толковый пост о технических писателях: кто такие, что умеют, в чём польза.
https://t.me/bor_64/94

Bor64

14:08пожаловаться #18

Ю

Юлия in DocOps-сообщество

vladimir

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

То есть второй вариант?
Простите за глупый вопрос, но с пандоком дела не имела еще)))

18:42пожаловаться #19

v

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

Юлия

То есть второй вариант?
Простите за глупый вопрос, но с пандоком дела не имела еще)))

Да, сначала идёт output, потом input, вроде)