Как написать грамотный гайд: правила для техписов и разрабов

Большинство гайдов по программному обеспечению написаны трагически плохо.

В них не хватает важной информации, и это мешает пользователям повторить описанные в руководстве процессы. Иногда автор исходит из скрытых предпосылок, которые не соответствуют ожиданиям читателя.

Но есть и хорошая новость: научиться писать грамотные руководства проще, чем вы думаете. Следуйте нескольким простым правилам, и ваши тексты будут выделяться на фоне повсеместной посредственности.

Правила

  1. Пишите для чайников

  2. Пообещайте в заголовке чёткий результат

  3. (далее…)

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

Привет! Меня зовут Паша Молянов, я руковожу агентством контент-маркетинга. К нам приходят за статьями, постами, рассылками, курсами, базами знаний, сайтами, спецпроектами. У некоторых лидов глаза по пять копеек, когда они узнают: статья в блог стоит от 30 тысяч рублей, три статьи на VC — 180 тысяч рублей, пост в соцсети — минимум 5 тысяч рублей. Ведь классные авторы и редакторы на фрилансе пишут статьи по 7-10 тысяч рублей. Да и подешевле вполне можно найти.

Тем не менее даже с такими ценами у нас и у других контент-агентств появляются новые клиенты. И это даже не обязательно крупный бизнес, которому просто некуда тратить деньги.

(далее…)

Экология человеческих ресурсов против кадрового голода

Почему со всех сторон говорят, что нужно больше рожать? Как связаны регулярные увеличения пенсионного возраста, заброшенные города и деревни, бегство учителей из школ на заводы или в такси, приток мигрантов из других стран, хайп на тему искусственного интеллекта и роботов. Обо всем об этом я как hr расскажу с точки зрения демографии, рынка труда, менеджмента и щепотки экономики. Зачем нужно применять экологичные подходы к людям (и речь не про вытирание соплей сотрудникам).

Демография против рынка труда

(далее…)

Как писать баг-репорты, которые помогут всей команде

Всем привет!

Меня зовут Михаил, я специалист по тестированию в компании ITFB Group.
Работа тестировщика состоит из множества различных задач, но самые важные — это обнаружение и описание багов. Однако сам процесс выявления ошибки — лишь половина дела. Настоящая ценность для команды разработки заключается в грамотном документировании найденного бага, а именно — в создании баг-репорта.

(далее…)

Страх и ненависть заказной разработки — семь смертных грехов заказчиков и исполнителей

Ненависть к аутсорс-командам разработки можно сравнить только с ненавистью к строителям. Я уверен, что причины такой ненависти очень похожи: относительно низкий порог входа, при этом любой неуч с клавиатурой и мышью уже норовит назвать себя новым EPAM Systems, как и строители — ГК Самолетом.

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

(далее…)

Как переработать образовательный курс и сохранить баланс между работой и семьей

UX — как квантовая физика

Знакомство с UX как с дисциплиной мне напоминает знакомство школьника с квантовым миром через уроки химии, где и электроны, нейтроны и протоны пожизненно чеканятся в создание как корпускулы. Поверхностное знакомство с квантово-волновым дуализмом в старших классах, не только не вносит ясности, но и рисуют официально признанную научную картину мира совсем уж абсурдной. В итоге мы имеем противостояние Копенгагенской интерпретации и сомнительных, порой непроверяемых теорий скрытых параметров, теневых фотонов и мультиверсов.

(далее…)

Всех под одну гребенку: пошаговая инструкция отказа от демотивации сотрудников с помощью теста Герчикова

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

(далее…)

Книжный кружок. Рецензия на книгу «Настоящий СТО»

Всем привет, с вами Сергей Задорожный, руководитель отдела платформенных решений банка «Центр‑инвест» и один из авторов курса «DevOps для эксплуатации и разработки» от Яндекс Практикума.

моя любимая книжная полочка

моя любимая книжная полочка

(далее…)

Вот почему вы скоро возненавидите свою работу

Я два года проработал менеджером в фитнес-клубе. Я начинал с нуля и впервые в жизни почувствовал, что у меня что-то по-настоящему получается. С начальником у меня тоже были хорошие отношения. Он верил в меня больше, чем я сам, и постоянно давал новые задачи.

Но я постоянно перерабатывал: подъём в пять утра, весь день на ногах, домой возвращался за полночь, и так шесть дней в неделю. Я чувствовал, что выжат как лимон, но убеждал себя: усталость — это нормально, если не устал, значит, плохо работал.

(далее…)