Size: a a a

Technical Writing 101

2018 May 07
Technical Writing 101
источник
Technical Writing 101
В Твиттере узрел, что есть отдельный RFC (https://ru.wikipedia.org/wiki/RFC) на использование слова MUST, SHOULD, MAY в описании тех. продуктов https://tools.ietf.org/html/rfc2119
источник
2018 May 10
Technical Writing 101
Немного о грамотном подборе шрифтов для всяческой Complex Data (списки, аннотации и т.д) https://www.typography.com/blog/fonts-for-complex-data
источник
Technical Writing 101
В ядрах всех крупных ОС обнаружена опасная уязвимость, которая позволяет получить доступ к памяти ядра или перехватить контроль над системой.

Уязвимости подвержены решения следующих производителей: Apple, DragonFly BSD Project, FreeBSD Project, ядро Linux, Microsoft, Red Hat, SUSE Linux, Ubuntu, VMware, Xen.

А причиной всему знаете что? Разработчики неправильно поняли инструкции в руководствах Intel и AMD.

That’s why грамотная документация может спасти мир!

Больше информации по ссылочке: https://www.kb.cert.org/vuls/id/631579
источник
Technical Writing 101
То же самое, но на русском —> http://www.opennet.ru/opennews/art.shtml?num=48569
источник
2018 May 11
Technical Writing 101
Там вышла новая версия Marked 2, ПРЕВЬЮВЕРА маркдауновской разметки. Пишете в Markdown в своем текстовом редакторе, а в соседнем окошке все красиво отрисовывается, экспортится, еще и темы красивые есть. К тому же, для текстовых джедаев, которые пользуются Scrivener — есть поддержка и его формата, что упрощает работу с гигантскими объемами текста. Чейгджлог тут http://marked2app.com/help/changelog.html, а качать вот тут http://marked2app.com/ (есть демо)
источник
2018 May 14
Technical Writing 101
Прозрачно и максимально доступно написанная (и переведенная к тому же на русский!) инструкция по Семантическому Версионированию от соучредителя GitHub https://semver.org/lang/ru/spec/v2.0.0.html
источник
Technical Writing 101
И один из >ЛУЧШИХ< мануалов которые я видел на эту тему. Красиво, практично, понятно даже младенцу. Стайлгайд по написанию самых-пресамых чейнджлогов. Берите на вооружение! https://keepachangelog.com/
источник
2018 May 16
Technical Writing 101
У Valve красивейше заредизайнился сайт и есть даже вакансия Писателя! https://www.valvesoftware.com/
источник
Technical Writing 101
источник
Technical Writing 101
источник
2018 May 21
Technical Writing 101
Небольшой тизер будущей статейки. На выходе имеем SVG :3
источник
2018 May 22
Technical Writing 101
Небольшая шпаргалка-чеклист по созданию видео-инструкций. Примерно так и выглядел весь процесс на одной из прошлых работ. Не самое веселое занятие, but still.
источник
2018 May 24
Technical Writing 101
Испытываю некий трепет при изучении старых документов легендарных штук. Тут максимально аналоговая документация Sonic the Hedgehog 2. Тасклист, рассчет коллизий c окружением и анимация бурления лавы.
источник
Technical Writing 101
источник
Technical Writing 101
источник
Technical Writing 101
источник
Technical Writing 101
источник
Technical Writing 101
источник
2018 May 26
Technical Writing 101
Markdown в Telegram
источник