Ознакомьтесь с нашей политикой обработки персональных данных
12:28 

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

Вот как с такими людьми работать.

URL
Комментарии
2015-11-25 в 12:32 

ссученый заяч
Кругом распиздяи, русофобия, аниме и онанизм.
КАК ПОЛОЖЕНО ДЕЛАЙ

2015-11-25 в 12:32 

ссученый заяч
Кругом распиздяи, русофобия, аниме и онанизм.
ХУЛЕ ТЫ КАК ЧМОШНИК

2015-11-25 в 12:32 

ссученый заяч
Кругом распиздяи, русофобия, аниме и онанизм.
УМНЫЙ ДОХУЯ ШТОЛЕ

2015-11-25 в 12:54 

Mona Jenks
У меня так в вузике живую оригинальную курсовую с кучей здравых мыслей завернули. Тогда я скачал из интернетов полный квазинаучный бред типа размышлений домохозяйки на тему, перерерайтил с использованием сложных терминов и получил свою пятёрку с овациями.

2015-11-25 в 14:00 

Marked
Борюсь с хаосом. Хаос обречен.
Нет, я б еще понял ТЗ или там договор — там еще уместно требовать сухую точность формулировок. Но мануалы?.. :facepalm:

2015-11-25 в 15:13 

каздалевский
Далее, будучи пойманным за руку, господин Кадзалевский усугубляет ситуацию // Tea Party №0
Заедает, а насколько живой там был язык?

2015-11-26 в 10:46 

Заедает
Завтра не будет, вчера уже было, любите маму, мойте руки мылом
каздалевский, мануал был написан в режиме диалога с потенциальным пользователем, вроде "а теперь рассмотрим на примере ХХХ как вы можете сделать УУУ". Потенциальный пользователь сказал что ему это нахуй не надо и надо чтоб обезличенно и по госту.

URL
2015-11-26 в 10:49 

каздалевский
Далее, будучи пойманным за руку, господин Кадзалевский усугубляет ситуацию // Tea Party №0
Заедает, ну есди это заранее не было согласовано, это ваш факап, ящетаю.

Мануалы так не пишутся, реально, как технический писатель говорю.

2015-11-26 в 10:51 

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

URL
2015-11-26 в 10:56 

каздалевский
Далее, будучи пойманным за руку, господин Кадзалевский усугубляет ситуацию // Tea Party №0
Заедает, манул должен быть написан так, чтобы у самого тупого одноклеточного дегенерата не возникало никаких вопросов.

Это первичный документ для работы, он должен быть примитивным и односложным как валенок.

Канцелярит далеко не всегда означает простой и понятный текст, скорее всего, выйдет наоборот. "данное действие возможно осуществить при помощи нажатия пальцем на поверхность кнопки".

Вот когда ты пишешь книгу-обучалку, там как угодно.

2015-11-26 в 10:58 

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

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

URL
2015-11-26 в 11:05 

каздалевский
Далее, будучи пойманным за руку, господин Кадзалевский усугубляет ситуацию // Tea Party №0
Заедает, нет, он должен быть таким, чтобы:

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

чувак хотел именно этого, вход в систему происходит по нажатию мышки на кнопку вход в систему

Да, всё верно. Это можно написать нормальным языком, хотя придётся поплясать с синонимическими рядами и контролировать повторы. Тяжело, но не смертельно.

Если пишется в никаком лице: "Вход в систему выполняется нажатием кнопки Х". Если с обращениями, то "Для входа в систему нажмите кнопку Х". Так пишутся все манулы и одноклеточный дегенерат, не найдя привычных схем, будет страдать.

К лдноклеточныи дегенератам я не питаю никаких отрицательных эмоций, поэтому не хочу, чтобы они страдали.

2015-11-26 в 11:06 

Заедает
Завтра не будет, вчера уже было, любите маму, мойте руки мылом
каздалевский, просто ты тоже поражен тяжелым наследием советского союза =\

URL
2015-11-26 в 11:12 

каздалевский
Далее, будучи пойманным за руку, господин Кадзалевский усугубляет ситуацию // Tea Party №0
Заедает, нет, просто я преподавал, я писал мануалы, я писал методички, руководства и я имел прямой контакт с теми, кто сделанные мной руководства реально использовал.

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

Другие методы не работают вообще, либо ты с нуля даёшь чёткие понятные схемы, либо тебе ебут мозги.

2015-11-26 в 11:14 

каздалевский
Далее, будучи пойманным за руку, господин Кадзалевский усугубляет ситуацию // Tea Party №0
Ну это всё равно кароч что возмущаться нежеланию заказчика видеть на чертеже в уголках красивые орнаменты.

2015-11-26 в 11:15 

Заедает
Завтра не будет, вчера уже было, любите маму, мойте руки мылом
каздалевский, то чертежи, а то текст. Тексты для людей, а не для роботов.

URL
2015-11-26 в 11:16 

каздалевский
Далее, будучи пойманным за руку, господин Кадзалевский усугубляет ситуацию // Tea Party №0
Заедает, тексты для людей, всё верно. Люди допускают ошибки и не всегда всё понимают однозначно.

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

2015-11-26 в 11:17 

Заедает
Завтра не будет, вчера уже было, любите маму, мойте руки мылом
каздалевский, однозначность формулировок и четкость не подразумевает робоязыка.

URL
2015-11-26 в 11:19 

каздалевский
Далее, будучи пойманным за руку, господин Кадзалевский усугубляет ситуацию // Tea Party №0
Заедает, подразумевает.

Технический манул должен выглядеть очень похожим на листинг программы на языке программирования высокого уровня.

Делай А.
Делай Б.
Если выход Б = В, то делай Г, иначе делай Д.

2015-11-26 в 11:20 

Заедает
Завтра не будет, вчера уже было, любите маму, мойте руки мылом
каздалевский, нет, не должен

URL
2015-11-26 в 11:23 

каздалевский
Далее, будучи пойманным за руку, господин Кадзалевский усугубляет ситуацию // Tea Party №0
Заедает, должен.

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

Посмотри самолётные манулы, там всё кровью форматировано.

2015-11-26 в 11:29 

Заедает
Завтра не будет, вчера уже было, любите маму, мойте руки мылом
каздалевский, вот тебе пример хорошего руководства написанного хорошим языком support.twitter.com/

URL
2015-11-26 в 11:38 

каздалевский
Далее, будучи пойманным за руку, господин Кадзалевский усугубляет ситуацию // Tea Party №0
Заедает, ну и где тут "предположим вам надо залогиниться в систему"?

To create an account on the web:
Go to twitter.com and find the sign up box, or go directly to twitter.com/signup.
Enter your full name, phone number, and a password.
Click Sign up for Twitter.
In order to verify your phone number, we will send you an SMS text message with a code. Enter the verification code in the box provided. Learn more about having a phone number associated with your account here.

2015-11-26 в 12:51 

КаэС
я просто хочу жить в мире, растить картофель и мечтать! (с)
Заедает, как техпис поддрежу мишу. Максисально просто, коротко и понятно, по пунктам, а ещё лучше с картинками. Представь себе самого тупого пользователя, умножь его тупизну на три, напиши для него мануал.
То, про что ты говоришь, очень хорошо и приятно в обучающих книжках, а в инструкциях нет.

2015-11-26 в 12:52 

Заедает
Завтра не будет, вчера уже было, любите маму, мойте руки мылом
КаэС, инструкция и должна быть написана как обучающая книжка

URL
2015-11-26 в 12:54 

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

2015-11-26 в 12:56 

КаэС
я просто хочу жить в мире, растить картофель и мечтать! (с)
Говорю по опыту работы со студентами, написанию руководств пользователей, админов и последующего общентя со всеми ними. Хотя, для админа ещё можно поподробнее. Для пользователя просто, как топор.

2015-11-26 в 13:01 

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

URL
2015-11-26 в 13:06 

КаэС
я просто хочу жить в мире, растить картофель и мечтать! (с)
Заедает, оно скорее будет настолько лаконичным, что на человеческие обороты места не останется. Как писал миша, делай а, получай б, иначе в. Коротко и максимально однозначно.

2015-11-26 в 13:08 

Заедает
Завтра не будет, вчера уже было, любите маму, мойте руки мылом
вас всех травмировал советский союз :С

URL
   

Дневник

главная