Всё для технического документирования
+7 (495) 001-00-42
Разработка технической документации
Курсы для технических писателей
Программное обеспечение

Новости о техническом писательстве

Стоимость разработки контента (часть 4)

14.02.2014

14.02.14Ранее мы рассматривали стоимость разработки контента. А во сколько обойдётся его локализация? Если вы считаете, что это вас не касается и переводить свой контент вы никогда не будете, прочитайте сперва данную статью.


Ранее я рассказывала о стоимости разработки контента в Word, FrameMaker и InDesign, а также топикоориентированных инструментах. Цифры показывают, что дешевле работать в топикоориентированных инструментах авторинга из-за возможности повторного использования контента. А что насчёт локализации?

Локализация

Локализация – процесс перевода контента и адаптация его к другой культуре. Он включает не только перевод с одного языка на другой, но и изменение системы мер и поиск примеров, подходящих для данной культуры.

Читать дальше…



Стоимость разработки контента (часть 3)

12.02.2014

12.02.14Так как же сэкономить на разработке контента? Шерон Бёртон предлагает одно из возможных решений. Рассмотрите этот вариант, возможно, он придётся вам по вкусу.


В прошлых публикациях я рассказывала о стоимости разработки контента в Word и в таких неструктурированных инструментах, как FrameMaker или InDesign.

При разработке в Word вы теряете порядка 50% выделенных денег. В Frame или InDesign потери ниже и составляют около 20%. Word не позволяет повторно использовать контент, а сложности повторного использования в Frame или InDesign приводят к его жёсткому ограничению.

Ок, думаете вы, я все понял – нужно создавать и использовать контент более эффективно. Это дорого стоит. Нужно начинать думать о стоимости нашей стратегии создания контента.

И что же делать?

Как сказать. Это зависит от того, сколько у вас контента, сколько у вас писателей и сколько продуктов. А ещё это зависит от того, собираетесь ли вы в обозримом будущем переводить контент на другие языки.

Читать дальше…



Стоимость разработки контента (часть 2)

10.02.2014

10.02.14Надеемся, мы не слишком вас напугали цифрами в предыдущей публикации? В тот раз мы рассмотрели стоимость при разработке контента в одном инструменте, сегодня обсудим другие. А если суммы всё же покажутся вам несоразмерно высокими, ждите наших следующих публикаций. У нас ещё есть, чем вас порадовать.


В предыдущей публикации я рассказывала о том, как дорого создавать контент в Word. Я говорила, что команда ваших писателей тратит около 50% своего времени и ваших денег, потому что не может использовать контент повторно. А ещё они борются с приложением Word.

Я привела простой расчёт, чтобы показать, сколько денег тратится на разработку контента и сколько теряется, если вы используете Word.

Давайте рассмотрим стоимость создания контента в FrameMaker или другом инструменте разработки более высокого уровня. Существуют инструменты лучше Word, но, возможно, и их недостаточно. Читать дальше…



Стоимость разработки контента (часть 1)

07.02.2014

07.02.14Вы когда-нибудь задумывались, во сколько обходится разработка контента? Шерон Бёртон, менеджер по обучающим ресурсам в колледже Ричарда Хуиша, попыталась посчитать. Но не пугайтесь представленных сумм; как указывает сама автор, цифры даны довольно приблизительно, только для наглядности. К тому же стоимость подобной работы в Америке и странах СНГ существенно различается.


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

Возможно, эта группа работает в Word, потому что он поставлялся в стандартном пакете при покупке компьютера, так что он «бесплатен». Возможно, кое-что создаётся в PowerPoint, как например контент для ILT (инструкторских тренингов). Может быть, вы работаете в промышленности, которая должна соответствовать государственным и федеральным нормативам, например, в медицинской или финансовой отрасли, поэтому вы не можете просто игнорировать подобные документы.

Читать дальше…



Техническое писательство и DITA

31.01.2014

31.01Сегодня объектом нашего внимания стала познавательная статья Сьюзен Бодник, рассказывающая, что же такое система DITA, о которой мы уже упоминали в наших публикациях.


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

Читать дальше…



Эджайл и технические коммуникации: 4 обязательных пункта, чтобы стать членом эджайл-команды (часть 2)

22.01.2014

22.01.14Мы заканчиваем статью с советами техническому писателю, как стать полноправным членом команды. Сегодня мы узнаем, почему так важно брать на себя ответственность, что делать, чтобы остаться в проекте и почему иногда нужно спорить с разработчиками.


Участвуйте во всех областях разработки

Независимо от того, сколько раз вы это слышали или говорили, фраза «Я просто писатель» не освобождает вас от активной вовлеченности – невозможно стать одним из ключевых членов команды без полного погружения. Алан Прингл пишет об этом на сайте Scriptorium. Такой уровень участия гарантирует, что вы полностью вовлечены в проект с самого начала и знаете все требования, дизайн и что стоит за дизайном программного обеспечения. И это даёт вам дополнительное преимущество: «имидж», уважение, которое нужно, чтобы остаться в проекте.

Вы можете заработать этот имидж, выполняя несколько важных действий:

Читать дальше…



Эджайл и технические коммуникации: 4 обязательных пункта, чтобы стать членом эджайл-команды (часть 1)

20.01.2014

20.01.14Мы продолжаем цикл статей, посвящённых такому понятию, как эджайл. Сегодня речь пойдёт о том, почему технический писатель должен стать частью команды и как это сделать.


Эджайл-разработка в значительной мере опирается на быструю и чёткую коммуникацию. Следовательно, может показаться, что коммуникация не будет для нас проблемой. В конце концов, мы же профессиональные коммуникаторы. Дело в том, что коммуникация эджайл-команды часто наталкивается на препятствие в виде предвзятых идей о том, что технический писатель делает или какой вклад может внести в команду. И эти предубеждения поддерживаются как техническим писателем, так и другими членами эджайл-команды. Хотя, вероятно, вы и не можете изменить устоявшиеся понятия других людей, вы можете избавиться от своих собственных. Далее — четыре обязательных пункта для любого технического писателя, стремящегося стать ключевым членом эджайл-команды.

Говорите

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

Читать дальше…



Технический писатель Google. 3 месяца в компании (часть 3)

17.01.2014

17.01.14Мы заканчиваем публикацию статьи технического писателя Google Сары Мэддокс. Сегодня мы узнаем, какие инструменты используют работники компании, какими навыками должны обладать и какие преимущества можно получить, устроившись работать в Google.


Слова, код, разметка

Нужно ли уметь писать код, чтобы быть техническим писателем в Google? Это наиболее обсуждаемый вопрос. Я думаю, всё зависит от должности, занимаемой в Google. Для моей позиции, я бы сказала, было бы весьма невыгодно не уметь скомпоновать программный код.

Почти все, что мы создаем – это слова. Мы пишем в HTML или Markdown в зависимости от нашего выбора, либо существующего формата, если мы обновляем документ.

Читать дальше…



Технический писатель Google. 3 месяца в компании (часть 2)

15.01.2014

15.01.14Мы продолжаем статью Сары Мэддокс – технического писателя компании Google, в которой она рассказывает о своём рабочем дне, интересных традициях и безумно вкусных пирожных в кафе неподалёку.


День из жизни

Я приезжаю рано, около 7.30 утра. Но я прихожу на работу далеко не первая. Народ подтягивается в любое время суток – когда им удобнее.

Босые ноги, кофе, Большая Красная

Я бросаю ноутбук на стол и бегу к кофеварке. По пути я прохожу конференц-зал и улыбаюсь паре босых ног. Почему-то в это время дня здесь всегда находится парень, который развалился в кресле и чатится с кем-то через Google Hangout. Я вижу только ноги и коленки, выше стекло затемнено.  Думаю, он разговаривает с семьей где-то на другом континенте, а раннее утро – лучшее время их поймать.

Читать дальше…



Технический писатель Google. 3 месяца в компании (часть 1)

13.01.2014

13.01Представляем статью Сары Мэддокс, которая несколько месяцев назад получила место технического писателя в корпорации Google и теперь делится впечатлениями с читателями своего блога.


Многие спрашивают меня, каково же быть техническим писателем в Google. Я стала частью команды Google три месяца назад. Теперь, как красноречиво заметил мой руководитель, «блеск первых впечатлений от работы стирается», и я принимаюсь за будничную работу. Итак, каково это?

Тяжело ответить на этот вопрос. Это бодряще, страшно, весело, разочаровывающе, вдохновляюще, утомительно. Всё, чего можно ожидать от новой работы, и ещё многое. Мне это нравится. Чаще всего 😉

Чтобы ответить на вопрос, я начала записывать какие-то случайные мысли, а потом описала «день из жизни». Надеюсь, это даст вам некоторое представление о том, что я здесь творю.

Читать дальше…