Небольшая шпаргалка-чеклист по созданию видео-инструкций. Примерно так и выглядел весь процесс на одной из прошлых работ. Не самое веселое занятие, but still.

#checklist #en

Испытываю некий трепет при изучении старых документов легендарных штук. Тут максимально аналоговая документация Sonic the Hedgehog 2. Тасклист, рассчет коллизий c окружением и анимация бурления лавы.

#vintage #en

Markdown в Telegram

#markdown #en

Абсолютно никак не могу понять, зачем создают вот такие https://danmoop.github.io/plume/ проекты. И тысячи их на всяких producthunt, 3.5 базовых фичи для написания текста, одна более-мене уникальная и все. Просто окошко для набора текста. Остановитесь, пожалуйста.

#ide #en

Хороший пример подачи документации в IKEA-стиле, в виде картинок/комиксов https://code-cartoons.com/

#example #en

При поиске новой работы писателем, у вас наверняка попросят примеры прошлых работ и чтобы позорно не отправлять гору док-файлов предлагаю вам обратить внимание на сервис который поможет легко, и, что немаловажно, красиво организовать свою работу в аккуратное портфолио https://www.clippings.me/

Пример готового портфолио: http://www.mila-carter.com/

#career #en

Я люблю смотреть на профессию технического писателя более широко, поэтому вот вам отличный кусок видео-документации от Sega, 1996го года. По сути это "trainumentary" которое описывает базовые принципы профессии и более специфичные детали о работе тестером в самой Sega https://vimeo.com/166472288

#vintage #en #video

Можно даже понаблюдать как в 1995-ом выглядели багтрекинговые утилиты

TO INSTALL DOOM II:
1. Go to A or B Drive
2. Type INSTALL and press ENTER

#vintage #en

Какая удобная штука!

https://www.screely.com/

https://tldrlegal.com/ — отличный по реализации, но удручающий по смыслу сервис. На сайте собраны всемозможные software лицензии (GPL, MIT и т.д) описанные максимально простым языком, который понимают все, а не только юристы. This is how documentation should work

#legal #en

Подоспели видеоматериалы с Мини-Гипербатона про текстовые редакторы, но при беглом осмотре — слабовато, у меня про retext и remark намного полезнее:
https://events.yandex.ru/events/hyperbaton/24-may-2018/

#ide #video #conference

Очень, ну очень разумная мысль — изучать технологию параллельно создавая туториал по ней. И сам изначально больше поймешь, а когда нужно будет снова к ней вернуться можно глянуть что ты сам же и написал: https://nanxiao.me/en/learn-new-technology-through-writing-a-tutorial-about-it/

#article #en