Заказать звонок

Ogre (Все сообщения пользователя)

Внимание! У нас сбои с почтовым сервером! Если не пришло письмо о регистрации или смене пароля напишите нам на info@techwriters.ru! 
@twriters
 obmen_soobsheniyami.pngчат для технических писателей в Telegram

 Зарегистрируйтесь
Выбрать дату в календареВыбрать дату в календаре

Страницы: Пред. 1 2 3 4 5 След.
Трафик или траффик?
 
[quote="гена":3gqgrcz5]Столкнулся с такой странностью слово "трафик" (traffic) иногда пишется с одной "ф"? иногда с двумя "фф". Если с английского добуквенно переводить, то получается две - "ф", но правильно писать с одной. Почему так?[/quote:3gqgrcz5]
У меня ответный нескромный вопрос: а почему "офис"? ))
Сам спросил, сам отвечу, ок?
Потому что в заимствованных словах двойные согласные часто не сохраняются. Раньше написание "трафика" было не устоявшимся, сейчас в Русском орфографическом словаре Российской академии наук. под ред. В. В. Лопатина, электронную версию которого можно найти на грамоте.ру,  зафиксировано одно "ф".
Как организовать работу отдела документирования?
 
Коллеги, мы действительно говорим с вами на разных языках. Я предложил один из вариантов по предъявленным вводным. Причем сразу оговорился, что вариант кривой. Предлагайте свои, а не пытайтесь доказать мне, что я неправ :)
[quote="znapa":3ae531xv]Кроме номера версии в название файла документа можно добавлять еще и статус (см. ГОСТ 2.051). Статусы могут быть различными - как примите у себя в отделе, например, документ в работе (статус "Р"), документ проверен (статус "П") и т.д.[/quote:3ae531xv]
Статусы не вариант. Вам все равно придется использовать индексы, потому что в пределах статуса, допустим, "Р", может быть многамнога ревизий этого документа. Задача в том, чтобы была возможность "вытащить" или откатиться на любую понадобившуюся вам ревизию.
И не произносите при мне эту аббревиатуру, пожалуйста, мне от нее плохо )))
[quote="znapa":3ae531xv]Тогда не потребуется такого количества версий, да еще и подойдете напрямую к описанию жизненного цикла документа.
Что касается "косяка с человеческим фактором", то нужно разрабатывать регламент на процесс разработки документации.[/quote:3ae531xv]
Процесс разработки у меня описан. Это первое, что я делаю, устраиваясь в новую контору. Параллельно с этим разрабатываются шаблоны. Это минимум. Далее, если есть время и не сильно влом, разрабатываются глоссарии, "идеальные" составы и структуры документов, наполнение стандартных разделов.
Вот только все это никак не может невилировать человеческий фактор. Несколько сокращает его, но полностью не избавляет, ибо, описанный ADVANCED принцип "забыть и забить", остается незыблимым. И если вы считаете, что, описав регламент, вы обойдете его стороной, то приготовьтесь рано или поздно наткнуться на кучу какой-нить субстанции, которую вам придется разгребать.
[quote="ADVANCED":3ae531xv]Мы говорим на разных языках. Я вообще не понимаю как можно править PDF и сохранять его разные промежуточные версии. Наверное ПДФ делается из Ворда или каких-то других систем разработки документации??[/quote:3ae531xv]
А я где-то говорил про то, что правится сам пдф? Для меня пдф по умолчанию — конечный формат. Естественно, разрабатывается документ сначала в текстовом редакторе, откуда конвертируется в пдф.
[quote="ADVANCED":3ae531xv]Если в ворде, то можно изменения хранить в самом файле (в 2007 исправления и изменения) пока не будет завершено редактирование и не обязательно хранить 100 файлов с именами от 001 до 100 с разными стандартами.[/quote:3ae531xv]
Можно подробнее о том, как именно это реализуется в ворде? Можно работать с одним файлом под одним именем, при это каждая новая сессия работы с документом сохраняется отдельно в какой-то служебный файл, из которого потом можно вытащить любую версию? Это в ворде? Это не фантастика?
[quote="ADVANCED":3ae531xv]Если из других систем, то можно хранить исходники Subversion, он бесплатен, но полезен только для ""не бинарных" файлов. Встроенные утилиты позволяют посматривать изменения ( с подсветкой разницы).[/quote:3ae531xv]
Ну так выше я говорил о StarTeam. Он платен, но для меня работать с ним было очень удобно. В нем нет встроенных утилит для подсветки изменений, но мне для этих целей всегда хватало CompareIt, который, кроме всего прочего, дает статистическую инфу об изменениях в процентах, что очень удобно для отчетности и подсчета производительности труда техписа.
[quote="ADVANCED":3ae531xv]Если есть тестирование документации по файлу ПДФ, то не стоит его переименовывать каждый раз с новым именем. Изменять исходники, хранить их в Subversion, а ПДФ собирать после каждого изменения - всегда последняя версия. Subversion позволяет откатить назад любые изменения до любого момента, если последняя версия не удалась, то легко откатываемся назад. Почитайте в нете. Я его не рекламирую, просто работаю с текстовыми исходниками много лет, с вордом работал, но не делал множество копий с обновлениями.[/quote:3ae531xv]
Еще раз: пдф — конечный формат. Работа над документом ведется в ворде. Как только она завершается, документ конвертируется в пдф и выкладывается в соответствующую папку. Он там единственный, чтобы люди не в теме всегда брали актуальную версию, а не рыскали наугад по списку из 354 файлов.

[quote="ADVANCED":3ae531xv]Или если я все не так понял, расскажите, плз, о каких версиях вы говорите :) В качестве обмена опытом.[/quote:3ae531xv]
Я говорю о том, как можно попытаться смоделировать на файлсервере принцип системы контроля версий — при помощи индексов в названии файла. Это криво, работать с этим неудобно, постоянно допускаются ошибки, природу которых, в ряде случаев, узнать будет очень на не просто. Но без RCS я других возможностей не вижу.
Если вы их знаете, расскажите, буду премного благодарен )
Как организовать работу отдела документирования?
 
[quote="ADVANCED":1ahhx1wm]Надо либо писать изменения вручную, о чем можно забыть или "забить", либо хранить их в системе контроля версий просто с индексами. В индексах также описывать изменения вручную, на что также можно забить/забыть.
Грубо говоря, есть 10 файлов PDF + 1 readme.txt, в котором написано кто что когда изменял. Изменил документ, будь добр запиши что ты изменил, когда и зачем :D[/quote:1ahhx1wm]
Про косяк с человеческим фактором я же ж писал :) Все верно. Расскажете как от него избавиться? Буду премного благодарен.
Как организовать работу отдела документирования?
 
[quote="ADVANCED":krtsaidk]Расскажите как можно хранить изменения в файле PDF от версии к версии? Этот момент не встречали никогда.[/quote:krtsaidk]
Простите, я не понимаю о чем вы говорите. Есть документ, он "живет" на файлсервере. Надо каким-то образом отслеживать его версионность. При использовании системы контроля версии новая "ревизия" документа присваивается файлу автоматически. В любой момент времени доступна как старая версия файла, так и новая. Если пользователь не поленился и прописал в комментариях к новой ревизии документа отличия от старой, то совсем все хорошо...
У puhata, как я понял, сходные потребности, но работают они с файлсервером. Для того чтобы хоть как-то смоделировать в данном случае систему контроля версий, я предложил индексы в названии файла. Чтобы знать, чем файл с индексом 002 отличается от файла с индексом 003, необходимо вести внутри файла табличку с описанием изменений (или отдельный файл, как угодно). Причем тут расширение файла?
Как организовать работу отдела документирования?
 
[quote="ADVANCED":gepcg328]А если документ в PDF, то так просто не получится.[/quote:gepcg328]
Не вижу связи с форматом. Просвятите? ) Не удобно и дико для 21-го то века, но что делать, иногда и так извращаться приходится.
[quote="puhata":gepcg328]Это я и сам понимаю. За вариант сортировки спасибо, удобно.[/quote:gepcg328]
На самом деле удобного нет ничего. Слишком много человеческого фактора. Забыл индекс перещелкнуть и сиди потом в CompareIt сравнивай, вычищай. А если кто другой такой фигней пострадает? И концов уже не найдешь. Но на безрыбье, какгрица...

[quote="puhata":gepcg328]Что касается использования SharePoint, то это не для нашей компании точно) слишком дорого.[/quote:gepcg328]
За шарепоинт не скажу, не работал. 6-7 лет использовал в качестве системы контроля версий StarTeam. Удобная штука. Посмотрите, может, по деньгам она вам подойдет.
Как организовать работу отдела документирования?
 
[quote="puhata":1svaulo1]просто в папках[/quote:1svaulo1]
Это не есть гуд. Хорошо бы воспользоваться какой-нить системой контроля версий. Если с этим сложности, то версионность можно отслеживать путем добавления индекса в название файла. Например, <название файла>_001.doc. До 100 идет работа над документом, согласование, утверждение, внесение изменений по результатам проверок. После внесения изменений индекс увеличивается на единицу. Индекс 100 означает, что документ готов и его можно передавать клиентам. При таком подходе в самом документе необходимо прописывать историю: версия 015 — внесены изменения по резултатам проверки тестеровщиками; в раздел 5.2.8 добавлена информация о подключении переферийных устройств; раздел 4.5.11 удален, информация из него перенесена в 8.12.13. Ну и т. п.
Термины, пришедшие из мира ПК
 
http://www.microsoft.com/Language/ru-ru/StyleGuides.aspx
http://www.microsoft.com/Language/ru-ru/Terminology.aspx
Обсуждаем тесты
 
Цитата
Предлагаю всем критикам)) сделать тоже самое
Забыл еще одну вещь: имя файла "Тест 1" — не комильфо. Что-нить типа "who_is_techwriter_form.doc" было бы лучше.
Обсуждаем тесты
 
Цитата
Добавил в существующий файл опроса,  правки и вопросы (изменил и само название теста). Предлагаю всем критикам)) сделать тоже самое, потом отправим тест на доработку и сделаем такой, который даст максимально много полезной информации.
Браво! Избавились от "креативности" ))) Жму руку и снимаю шляпу! ))
"Заполненную форму необходимо выслать по указанному адресу (e-mail)" — где адрес? Нетути.
В "и т. п." надо поставить неразрывный пробел.
В "Вас" избавиться от прописной.
Задать для таблицы отступы сверху и снизу, чтобы она не "прилипала" к тексту.
Использовать один способ разделения однородных членов. Ср. "мужчина - женщина" (кстати в следующем сочетании пробелов перед и после дефиса нет), "интраверт-экстраверт" и "учебное заведение, курсы", "литература, искусство, музыка, танцы и т.п.".
Это все, конечно, косметика. По содержательной части, думаю, по понятным причинам, замечаний лично у меня не будет.
Да, и добавьте про знак зодика. Ну пажааалуууста, что вам стоит? ))
Обсуждаем тесты
 
Цитата
Перейдем теперь к конструктивной критике).
Уважаемый writer, я могу 100 раз ошибаться и быть субъективным, но, на мой взгляд, мы с ADVANCED высказывались исключительно конструктивно.
Самый главный вопрос, был задан, к сожалению не мной. Повторяться я уж не стал. А ведь этот вопрос должен себе задавать человек каждый раз, когда он за что-то берется.
Цитата
Какова цель этих тестов? Что реально полезного можно подчеркнуть, узнав, что твой коллега из Анадыря -весом 88 кг - голубоглазый брюнет - интраверт - фотограф - живет с родителями (папа геолог писал в молодости стихи маме-домохозяйке), учится по специальности "математик-программист" и подрабатывает тех.писом?
То есть, как мне кажется, если бы OlegAlm ответил лично себе на этот вопрос, прежде чем размещать опрос на этом ресурсе, то и негатив бы не полился,  просто потому что и опроса бы не было.
Я сразу скажу: в опросах никакой ценности не наблюдаю. Ни в каких. Но опрос про ПО резкого отторжения у меня не вызвал. Ну висит себе и висит. Кому-то, наверно, это нужно. Хотя я и в нем никакой пользы лично мне, техническому писателю, не вижу.
Когда же появился это "нечто"... Ну не шмагла я, не шмагла сдержаться. У меня сразу появилась гипотеза, что это развлекается троешник-аспирант, набирая себе материал для кандидатской. Вот мне очень интересно знать: я угадал? )))
Обсуждаем тесты
 
Цитата
Всем доброжелателям, так активно откликнувшихся на создание нового раздела ТОК
Не передергивайте, пожалуйста. Конкретно про раздел вам не сказали ни слова. А на критику бредоопроса обижаться — грех.
Что касается "сделайте хоть чего-нибудь, чтобы мир стал лучше", так вы извините: недоработанную идею дуракам не показывают. Профессионалам (не побоюсь этого слова) не показывают второсортное исполнение.
Вы бы, прежде чем обижаться, поправили бы от греха оранжевый блок от огромного количества пунктационных, стилистических и синтаксических ошибок. Вот и сделали бы этот мир чуть-чуть лучше. Безрамотного хлама в инете — 90 %. Зачем нам еще? Разбавили бы этот процент, а не стихи цитировали.
Обсуждаем тесты
 
Цитата
Зачем рассылать в каждую тему, если достаточно одного сообщения в одной теме????
Это больше походит на анкеты в подготовительной группе детсада для того, чтобы "кандидата" взяли в подходящий класс (первый) школы.
Уважаемый ADVANCED, ну зачем вы так? Ясно же, что не корысти ради, а пиара для )))
Обсуждаем тесты
 
Русскому языку в аспирантуре точно не учат.
И завершать мысль не заставляют.
"Заполненную форму необходимо выслать по указанному адрес (e-mail)."
Думается мне, что вот этот шедевр принадлежит перу этого же деятеля:
"Attention!
Открыт новый раздел «Тестирование, опросы, конкурсы (ТОК)». Теперь каждый посетитель форума (сайта) может найти здесь что-то для себя.
Новичок, мечтающий стать техническим писателем, может просмотреть результаты опросов и конкурсов, чтобы найти помощь в выборе профессии и познакомиться с тайнами профессии TW.
Опытный TW может принять участие во всех опросах и конкурсах, чтобы поделиться своими знаниями и профессионализмом. А для того, чтобы ясно представлять свой уровень профессионала TW может попробовать свои силы в тестах и занять подобающее место в рейтинге.
Посетитель, случайно (или по наводке знакомых) забредший на форум TechWriters.Ru сможет воочию убедиться в том, что TW такие же люди как он сам, со своими эмоциями, проблемами, радостями и горестями.
Мир технических писателей является частью общего мира и отражает все его надежды и мечты, достижения и катастрофы. Каждый живущий в мире не только подвергается воздействию окружающего, иногда весьма кардинально меняющего судьбу, но и способен сам повлиять на окружающий мир. Пожелаем всем изменений только к лучшему и с нашей помощью!
Заходи!"

Каждая строчка, каждое слово просит красной ручки, уж простите, уважаемые администраторы и модераторы.
Обсуждаем тесты
 
Есть мнение, что это резвится какой-то троешник психолог-аспирант. К тому же еще и флудер.
Обсуждаем тесты
 
У меня нет слов.
Из вордовского файла сделать справку
 
Можно.
1. Сохраняете док в ртф;
2. Запускаете H&M;
3. Выбираете New Project;
4. Отмечаете радио баттон "Import existing documentation from...";
5. В списке выбираете "RTF document created with MS Word";
6. Указываете месчтоположение файла;
7. Next;
8. В следующем окне укажите кодировку. Если файл-справки русский, то обязательно в "Character Set:" выберите "RUSSIAN_CHARSET";
9. ОК;
10. В левой части окна проверяйте оглавление. Придется пробежать по всему, так как не всегда соблюдается иерархия + может попасть что-то лишнее;
11. Жмете кнопку "Publish" и выбираете тип справки;
12. Наслаждаетесь полученным результатом.

В общих чертах — без заморочек с настройками — так.
Проконсультируй на форуме и получи бонусы на свой телефон!
 
Меня запишите.
Не корысти ради, а токмо из любви к искусству )
Название системы
 
[quote="ADVANCED":ccri7e34]Второе: В шапке я вижу 2 раза "форум", а третий раз "сайт" на 10 квадратных сантиметрах.[/quote:ccri7e34]
Каким инструментом измерения пользовались? ))))

[quote="ADVANCED":ccri7e34]Но есть Веб-интерфейсы для различных "систем", которые разрабатываются в данный момент и на этапе разработки можно назвать их по другому. А вот как назвать, не знаю. Но "система" мне не нравится :)[/quote:ccri7e34]
Все равно я не понимаю в чем проблема. Можно же не акцентировать внимание пользователя на иерархии "система — подсистема — компонент".
[i:ccri7e34]Программа "Транклюкатор" предназначена для... Программа позволяет работать в нескольких режимах: 1. сетевой, 2. автономный.
В сетевом режиме  "Транклюкатор" связывается с сервером... В автономном режиме подключение к серверу не производится, осуществляется работа с локальными ресурсами...[/i:ccri7e34]
Что там происходит на сервере, остается за рамками руководства пользователя. Про БД, про серверную часть можно не рассказывать.

[i:ccri7e34]Существует возможность работать с данными, хранящимися на сервере, не при помощи программы "Транклюкатор", а посредством веб-доступа. Веб-доступ может быть организован на любом компьютере, с установленным веб-браузером (Internet Explorer, Mozilla Firefox и т. п.) и подключенным к локальной сети или Интернету. При этом установка дополнительного программного обеспечения не требуется.[/i:ccri7e34]

как-нить так, не? :)
Название системы
 
[quote="ADVANCED":5kb4dm3q]Поясняю:при входе на этот форум появляется сообщение об успешном входе в "систему". На разных сайтах также отображается сообщение о входе в "систему", выход из "системы" и прочее...[/quote:5kb4dm3q]
конкретно по этому форуму ответ находится в шапке страницы :)
[quote="ADVANCED":5kb4dm3q]на ноуте пробел залит темным пивом (сладким), извиняюсь заневозможность нажать пробел :lol: Заголовок так и не смогисправить[/quote:5kb4dm3q]
экранная клавиатура рулит :)
Оценка производительности труда технического писателя
 
[quote="ADVANCED":32qzkb1n]Так нехватаетбеседысруководителем :([/quote:32qzkb1n]
По моим наблюдениям % 80 руководителей считают, что их обязанность только отдавать распоряжения и дрючить подчиненных в конце отчетного периода. О человеческом факторе забывают.
Я сейчас говорю даже не о контроле, а о простых человеческих отношениях. В друзья насильно, конечно, набиваться не нужно, но, считаю, что руководителю должно быть не западло время от времени интересоваться у подчиненного  семьей-детьми, успехами любимой футбольной команды и т. п. Но для некоторых это высший пилотаж. Иногда даже не то что руку не протягивают, а в принципе даже "здрасти" сказать с высоты своего положения не считают нужным.
[quote="ADVANCED":32qzkb1n]Тех.писа нужновключатьв цикл разработки в полной мере[/quote:32qzkb1n]
А как без этого? Документация — часть программного обеспечения. Процесс разработки документации должен быть а) описан, б) интегрирован в процесс разработки ПО. К сожалению, не все это понимают.
Оценка производительности труда технического писателя
 
[quote="puhata":2pt3dr8f]Получается что отчеты это единственный вариант контроля, да?[/quote:2pt3dr8f]
Нет, не так.
Кроме формального отчета (в устной или письменной форме, в зависимости от необходимости) можно проводить регулярные встречи с каждым техписом в отдельности. В зависимости от ситуации (берем за аксиому, что сотрудник нам хорошо знаком) можно "точечно" подходить к сотруднику и интересовать положением дел. То есть, например, вы знаете, что ваш сотрудник достиг определенной фазы в разработке документации. Эта фаза у него проблемна. В такой момент можно и нужно к нему подойти и спросить как дела, нужна ли помощь и т.п.
Никогда не бывает лишним спросить у техписа как дела, чем он сейчас занимается, есть ли вопросы, всей ли информации, хардваре и прочее в данный момент ему хватает, чтобы выполнить его задачу. Такой "контроль" — хаотичен. Его не надо прогнозировать.
Прошу прощения, надо убегать. Если вспомню еще что-то, то обязательно допишу.
Оценка производительности труда технического писателя
 
[b:f06a8sd8]Дмитрий[/b:f06a8sd8], я ж с вами ни разу не спорю, все верно. Контроль в том или ином виде должен быть постоянным. Отчеты тоже должны быть — устные, письменные — на усмотрение руководителя. Но должны. Из вашего поста просто мне показалось, что вы их совсем отрицаете, как класс. :)
И опять же у каждого руководителя свои резоны, как "измываться" над сотрудниками. В моей ситуации без письменных было не обойтись, ибо держать в голове планы на 10 техписов и 2-х переводчиков, мало реально. 10 продуктов, 2 версии каждого + постоянные рокировки, изменение планов и тп... брр... а так, в бумажку за этот месяц посмотрел, в бумажку за прошлый посмотрел и вроде как картинка начинает складываться: тут техпис не успел потому-то и перенес работу на тогда-то; тут работы по этому проекту не завершены, так как приоритеты поменялись. Ну и так далее.
Про все остальное я бы, конечно, с вами подискутировал, но это уже будет явный оффтоп. :)
Предлагаю  теоретизировать и спорить по мере появления конкретных вопросов.
Оценка производительности труда технического писателя
 
[quote="Дмитрий":3p3o768v]На отчеты лучше не полагаться[/quote:3p3o768v]
Вот с этим я категорически не согласен.
Планирование на какой-то период нужно однозначно. Временным диапазоном, на мой взгляд, целесообразнее сделать месяц. Но тут, думается, все зависит от специфики каждого предприятия.
По завершению выбранного временного диапазона каждый сотрудник должен составить отчет о проделанной работе. Если что-то из запланированного не успел, то обязательно должна быть указана причина.
Если планирования и отчетов нет, то как вы будете контролировать процесс? Как вы узнаете, какие задачи приоритетные, а какие могут подождать? Как ваш сотрудник узнает, что он должен сконцентрироваться вот на этом, а вот то может подождать? Как вы, в конце концов, как руководитель подразделения документации, будете отчитываться перед руководством? Оно ж вас по-любому спросит, почему нету доки для отправки заказчику... Что вы им собираетесь ответить? Что делали не то, что нужно, извините?
Плюс ко всему, отчетность организует рядовых сотрудников. Схалявить уже так просто не получится, так как знаешь, что в конце месяца с тебя будут спрашивать...
Варианты контроля? У вас их ровно 1 перечислен. Второй — это не вариант, это — русский авось.
Отзывы по работе с программой Dr.Explain
 
[quote="гена":bw5g0n3b]так пока не поздно вас нужно остановить :lol:[/quote:bw5g0n3b]
Нет, коллеги, пока не поздно нужно переквалифицироваться. Корчеватель нам ну никак не переплюнуть :)
Отзывы по работе с программой Dr.Explain
 
[quote="writer":7h0azlzd]Возможно, скоро техпису писать самому уже будет не нужно))[/quote:7h0azlzd]
Заявление уже писать или время еще есть? ))
Страницы: Пред. 1 2 3 4 5 След.

Рейтинг@Mail.ru