Size: a a a

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

2019 October 01

iv

iakov v in DocOps-сообщество
Nick Volynkin
Мой хороший пример — это релизные посты GitLab, их всегда было интересно читать.

Сам внимательно читаю https://www.sphinx-doc.org/en/master/changes.html и https://jekyllrb.com/news/. Оба информативные, но по внешнему виду и удобству чтения они так себе.
Gitlab релизится настолько часто, что логи уже читать не успеваешь :)
источник

NV

Nick Volynkin in DocOps-сообщество
iakov v
Gitlab релизится настолько часто, что логи уже читать не успеваешь :)
Раз в месяц же, или они ещё ускорились?
источник

iv

iakov v in DocOps-сообщество
По ощущениям чуть ли не каждую неделю уже
источник

EB

Elena Bolshakova in DocOps-сообщество
Сейчас прилетел апдейт и напомнил: читаю внимательно release notes Телеграма.

По работе внимательнее всего читаю про mysql https://dev.mysql.com/doc/relnotes/mysql/8.0/en/ ну и про библиотеки
источник

NV

Nick Volynkin in DocOps-сообщество
Восстание машин предотвращено
источник

H

Hartmann in DocOps-сообщество
ID:
Какие самые крутые changelog'и вы видели? А какие вы внимательно читаете перед каждым обновлением? От каких больше всего пользы?

Расскажите в @docsascode, а?
Ничего лучше, чем у Sketch нет.


https://www.sketch.com/updates/
источник
2019 October 02

КМ

Константин Медведев in DocOps-сообщество
ID:
Какие самые крутые changelog'и вы видели? А какие вы внимательно читаете перед каждым обновлением? От каких больше всего пользы?

Расскажите в @docsascode, а?
Доброе утро! Вставлю свои пять копеек про подход Notion, который они ведут используя ... Notion :)

https://www.notion.so/What-s-New-157765353f2c4705bd45474e5ba8b46c
источник

NV

Nick Volynkin in DocOps-сообщество
Константин Медведев
Доброе утро! Вставлю свои пять копеек про подход Notion, который они ведут используя ... Notion :)

https://www.notion.so/What-s-New-157765353f2c4705bd45474e5ba8b46c
Вот так неожиданость )
источник

FM

Fox Mulder in DocOps-сообщество
как вы думаете, должен ли техпис обладать языком канцеляризма или это то, чего он должен избегать?
источник

VI

Vladimir Izmalkov in DocOps-сообщество
Fox Mulder
как вы думаете, должен ли техпис обладать языком канцеляризма или это то, чего он должен избегать?
этот язык нужен, чтобы общаться с чиновниками на одном языке
источник

VI

Vladimir Izmalkov in DocOps-сообщество
если ца или клиент - гос, то да
источник

OY

Olga Yesina in DocOps-сообщество
Fox Mulder
как вы думаете, должен ли техпис обладать языком канцеляризма или это то, чего он должен избегать?
Для разных целевых аудиторий нужен разный язык
источник

FM

Fox Mulder in DocOps-сообщество
Vladimir Izmalkov
этот язык нужен, чтобы общаться с чиновниками на одном языке
А не считаете ли вы, что такой язык формирует подобное же мыслеизложение у техписа уже на постоянной основе и он становится не способен выражаться по другому?
источник

VI

Vladimir Izmalkov in DocOps-сообщество
Fox Mulder
А не считаете ли вы, что такой язык формирует подобное же мыслеизложение у техписа уже на постоянной основе и он становится не способен выражаться по другому?
лично у меня - да, но я особый случай. Я три месяца назад как из НИИ уволился =)
источник

VI

Vladimir Izmalkov in DocOps-сообщество
неспособен - точно нет, просто дело привычки
источник

VI

Vladimir Izmalkov in DocOps-сообщество
при стандартной обучаемости - не составляет труда переучиться или даже совмещать
источник

FM

Fox Mulder in DocOps-сообщество
То есть, тот техпис, который, допустим 10 лет, писал документы согласно ГОСТ и тут перейдя в коммерческий сектр с ЦА=пользователи/программисты, просто не  способен сломать свои базисы.
Например, согласно книги "Пиши, сокращая" очень много из того мы используем в документации является канцеляризмом.
источник

H

Hartmann in DocOps-сообщество
Fox Mulder
как вы думаете, должен ли техпис обладать языком канцеляризма или это то, чего он должен избегать?
Ну, если по роду службы, он вынужден(!) общаться с канцелярскими крысами, то уж придётся обладать.
источник

FM

Fox Mulder in DocOps-сообщество
Но человек не робот и не возможно заливать в мозг новую прошивку при смене ЦА
источник

H

Hartmann in DocOps-сообщество
Fox Mulder
То есть, тот техпис, который, допустим 10 лет, писал документы согласно ГОСТ и тут перейдя в коммерческий сектр с ЦА=пользователи/программисты, просто не  способен сломать свои базисы.
Например, согласно книги "Пиши, сокращая" очень много из того мы используем в документации является канцеляризмом.
А с какой целью он после того, как оттрубил десятку ломанулся не в туда? Пусть там и остаётся. 10 лет же его всё устраивало. Чё щас-то не так.
источник