Создание идеального теста и оценок технического писателя для SaaS
Опубликовано: 2023-04-24Техническое письмо соединяет мир продаж и технологий. Он упрощает сложные концепции таким образом, чтобы удовлетворить как лиц, принимающих решения, так и обычных пользователей.
Итак, следует ли вам нанять опытного писателя или поручить разработчику написать техническую документацию самостоятельно? Ответ не должен быть ни тем, ни другим. Вам нужен отличный технический писатель.
Почему Saas должен нанимать технических писателей?
Источник: Pexels
Навыки письма не обязательно означают хорошее техническое письмо. Это также верно для разработчиков, которые сами работали над приложениями.
Великим техническим писателям не обязательно быть экспертами в программировании. Им просто нужно знать достаточно, чтобы продемонстрировать преимущества программного обеспечения и его преимущества для конечного пользователя. Это обеспечивает:
Улучшенный опыт продаж
Технические писатели отвечают как за конечных пользователей, так и за лиц, принимающих решения. Ваши технические писатели помогают отделам продаж создавать понятный контент. И когда конечные пользователи получают программное обеспечение, они также получают улучшенный опыт работы с продуктом.
Улучшенный опыт продукта
Отличительной чертой отличного программного обеспечения является то, насколько оно интуитивно понятно для новых пользователей. Руководства и образовательный контент могут помочь пользователям сформулировать способы использования вашего продукта для решения определенных проблем. В конечном итоге это приводит к улучшению сознания.
Повышение осведомленности о технологиях
Технологии развиваются быстро. Если вы работаете в индустрии SaaS, выживание означает идти в ногу с последними тенденциями. Процветание, с другой стороны, означает оставаться на шаг впереди.
Технические писатели могут предоставлять документацию по новейшим технологиям, помогать разработчикам с обновлениями продуктов и продвигать ценный контент для вашей целевой аудитории.
Как оценить навыки технического писателя
Есть несколько способов проверить, соответствует ли технический писатель вашим стандартам. Вот пять самых популярных способов оценить навыки технического писателя:
Технические навыки письма
Техническое письмо охватывает широкий спектр знаний. Вам нужен писатель, который демонстрирует знания и навыки в следующем:
- Коммуникация.
- Исследовать.
- Взаимодействие с отделами продаж и технической разработки.
- Гибкие стили написания для разных сегментов аудитории.
- Достаточно знаний в таких областях, как документация HTML, CSS или API.
Способность упростить сложные концепции
Как упоминалось ранее, технические писатели должны обслуживать как конечных пользователей, так и лиц, принимающих решения. Технические писатели достигают этого, упрощая сложные концепции до привлекательных и удобоваримых фрагментов.
Идее использования нового продукта или услуги, скорее всего, придется подняться на несколько ступенек, прежде чем она будет одобрена. В большинстве случаев он должен проходить через людей, не разбирающихся в технологиях.
Знакомство с жизненным циклом разработки документов
Технические писатели, знакомые с DDLC (жизненный цикл разработки документов), могут повысить качество вашего контента, его точность и скорость его доставки вашей аудитории.
Он следует следующим фазам:
- Анализ и разработка стратегии
- Дизайн
- Разработка контента и рецензирование документов.
- Издательский
- Обновления документации
Анализ аудитории
Великие технические писатели могут менять свой стиль письма в зависимости от целевой аудитории. В некоторых случаях более формальное письмо с акцентом на технические аспекты может работать лучше всего.
Другие требуют более непринужденного подхода. Ключ в том, чтобы понять, когда и где использовать эти стили письма, чтобы получить максимальную отдачу.
Отраслевой опыт
Техническим писателям нужно достаточно знаний, чтобы понимать механизмы и винтики продукта или услуги SaaS. Вы можете оценить знания вашего кандидата с помощью различных тестов, таких как:
- Знание продукта: CRM, Shopify, WooCommerce
- Ролевые знания: разработчик WordPress, разработчик полного стека.
- Знание кодирования: JavaScript, CSS или HTML начального уровня: отладка.
Как структурировать тест технического писателя
Источник: Unsplash
Структура вашего оценочного теста технического писателя зависит от того, что нужно вашей компании. Но обычно это включает в себя следующее:
Язык
Языковой тест должен включать основные грамматические и языковые вопросы или ситуационные примеры. Вы можете задать такие вопросы, как:
- В чем разница между «войти в систему» и «войти в систему»?
- Чем настройка отличается от «настройки»?
- Когда ставить через дефис определенные слова, такие как аддон или аддон?
- Рекомендации по построению предложений.
- Пассивный и активный залог.
Документация API
Этот тест охватывает технические аспекты технического письма. Здесь вы можете задать такие вопросы, как:
- Что такое API?
- Вопросы о платформе, такие как «Что такое Github?».
- Вопросы, связанные с кодированием.
- Что такое открытый документ?
- Слияние коммитов и ребазинг в Git.
Индустриальная осведомленность
Эта часть теста посвящена тому, насколько хорошо технический писатель осведомлен о тонкостях и вне отрасли, в которой он работает. Им следует ожидать таких вопросов, как:
- Вопросы, связанные с текущими тенденциями в отрасли.
- Отраслевой жаргон / технические термины.
- Что такое ретроспектива спринта?
- Вопросы по техническому английскому письму.
- Что такое UML-диаграмма?
Оптимизация и автоматизация процесса найма
Поиск идеального технического писателя для вашего SaaS-бизнеса требует времени. К счастью, вам не нужно кропотливо делать что-то вручную. Вы можете автоматизировать неотъемлемые аспекты процесса найма, такие как:
Описание вакансии Автоматизация
Если вы используете платформу для тестирования технического письма, вы часто найдете сотни шаблонов, готовых к персонализации. Вам не пришлось бы тратить так много времени на составление должностных инструкций. С помощью шаблонов достаточно нескольких минут, чтобы привести копию в соответствие с тем, что вы ищете.
Автоматизация написания оценивания
Следующим шагом после представления описания работы и формы заявки является оценка технических навыков письма соискателей. Вы можете использовать готовые шаблоны, чтобы автоматизировать процесс.
Эти шаблоны могут включать краткое содержание, справочную документацию, примеры, объем работ и краткое изложение того, как будут оцениваться результаты работы кандидата.
Автоматизация отслеживания электронной почты
Независимо от того, прошел ли ваш заявитель первоначальные оценки или нет, он может немедленно получить обновление статуса заявки через автоматическое отслеживание по электронной почте.
С заранее написанными электронными письмами для обоих сценариев вы можете легко уведомить кандидатов и помочь им перейти к следующему этапу процесса. Отправка немедленных обновлений способствует созданию эффективной рабочей среды, к которой писатели были бы рады присоединиться.
Ключевые выводы
Технические писатели необходимы для любого бизнеса. Они могут преодолеть разрыв между продажами и технологиями и помочь улучшить взаимодействие с пользователем, качество продукта и техническую осведомленность. Итак, если вы хотите нанять технического писателя, рассмотрите следующее:
- Как бы вы оценили их способности к техническому письму?
- Как бы вы автоматизировали и оптимизировали процесс найма.
- Вопросы, которые вы хотите задать абитуриентам.
- Опыт соискателя в отрасли.
- И их способность упрощать сложные концепции.