Size: a a a

2020 December 02

AS

Aleksey Shirokikh in SPbLUG chat
вот для описания сервисов я взял вот это https://github.com/SkeltonThatcher/run-book-template/blob/master/run-book-template.md и довёл до местных реалий
источник

AS

Aleksey Shirokikh in SPbLUG chat
теперь писать доку на приёмку сервиса относительно просто. но это документация типа референса. вопрос ответ
источник

AS

Aleksey Shirokikh in SPbLUG chat
а мне надо "продающую" доку. что бы взять и поехать и я не понимаю как её писать. точнее я прочитал уже 2 десятка
how to write perfect tutorials но получается что всё херня переписывай. ибо не проходит даже внутренний контроль качества не то что внешний
источник

D

Denis in SPbLUG chat
Aleksey Shirokikh
а мне надо "продающую" доку. что бы взять и поехать и я не понимаю как её писать. точнее я прочитал уже 2 десятка
how to write perfect tutorials но получается что всё херня переписывай. ибо не проходит даже внутренний контроль качества не то что внешний
Сложна.
источник

D

Denis in SPbLUG chat
Ай ноу ват ю фил
источник

AS

Aleksey Shirokikh in SPbLUG chat
кажется будто бы она фигово шаблонизируется. но может есть подходы ?
я уже знаю про то что писать надо для аудитории и задевать насущные вопросы для нее.
знаю что нужно показывать результат и готовить читателя к тому что ему предстоит сделать и чему научитсять. но блять сука слова какие то надо писать. ппц.
источник

DK

Dmitriy K in SPbLUG chat
В школе сочинения плохо писал?
источник

AS

Aleksey Shirokikh in SPbLUG chat
3ояк почти все годы. а что есть технари которые хорошо ?
источник

AF

Andrey F in SPbLUG chat
Denis
Я так тоже хочу
и шоб с автозаполнением
источник

D

Denis in SPbLUG chat
Andrey F
и шоб с автозаполнением
Конешно
источник

AY

Andrei Yemelianov in SPbLUG chat
поизучаю
может пригодиться
источник

DK

Dmitriy K in SPbLUG chat
Имеются. Смысл простой, накидай тезисов, потом к ним "красивостей" добавляй.
источник

AY

Andrei Yemelianov in SPbLUG chat
Aleksey Shirokikh
3ояк почти все годы. а что есть технари которые хорошо ?
я таких знаю
(у меня обратная ситуация: я из гуманитариев в IT подался)
источник

D

Denis in SPbLUG chat
Dmitriy K
Имеются. Смысл простой, накидай тезисов, потом к ним "красивостей" добавляй.
В кавычках вся соль
источник

DK

Dmitriy K in SPbLUG chat
Не "штирлиц шёл по коридору", а "штирлиц с мрачным лицом, пошатываясь от усталости и вздыхая, медленно и неспеша шёл по длинному коридору на встречу с мюллером"
источник

DK

Dmitriy K in SPbLUG chat
Я так выпускное сочинение растянул на необходимый объем
источник

D

Denis in SPbLUG chat
Dmitriy K
Не "штирлиц шёл по коридору", а "штирлиц с мрачным лицом, пошатываясь от усталости и вздыхая, медленно и неспеша шёл по длинному коридору на встречу с мюллером"
Для технаря тут овердофига слов
источник

DK

Dmitriy K in SPbLUG chat
Алексею "продавать" надо
источник

D

Denis in SPbLUG chat
Dmitriy K
Я так выпускное сочинение растянул на необходимый объем
Техника понятна. Известна :)
У меня так жена учит ребенку сочинения писать
источник

И

Иван in SPbLUG chat
может лучше так:
вчера  "штирлиц шёл по коридору на встречу с мюллером"
источник