Ознакомьтесь с нашей политикой обработки персональных данных
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
2015-11-26 в 13:14 

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

2015-11-26 в 13:44 

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

Совок впитал прусскую техническую школу от и до, всё, что в совке было годного, Королёв, самолёты - это всё наследние прусской школы, сумрачного тевтонского гения.

2015-11-26 в 14:03 

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

URL
2015-11-26 в 14:06 

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

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

2015-11-26 в 14:11 

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

URL
2015-11-26 в 16:23 

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

Наоборот, говорить, что это глупости и их надо нарушать - это совать пальцы в розетку, работать на токарном станке без защитных очков, не делать прививок, не носить шапку на морозе etc.

В отличие от религии, техника - это строго научная сфера, оперирующая строгими научными терминами и поэтому использующая максимально формализованные тексты.

2015-11-26 в 17:03 

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

URL
2015-11-26 в 17:25 

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

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

* недостаточно профпригодный
* недостаточно знающий язык
* находящийся в цейтноте

и т.д.

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

Это ДОКУМЕНТ, а не творчество. Это для работы, информация.

Много ты видел гаечных ключей с виньетками? Молотков с инкрустацией? А почему?

Потому что это НЕ НУЖНО ДЛЯ РАБОТЫ. В мануале должно быть то, что необходимо человеку для работы. Всё остальное из мануала следует выкинуть.

Мануал должен легко разбиваться на отдельные детали. Каждая из которых - самодостаточная единица. Легко укладывается в мозгу.

2015-11-26 в 17:27 

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

URL
2015-11-26 в 17:31 

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

Который, якобы, не может после работы читать Грибоедова, прихлёбывая компот из облепихи.

Человеку для работы ты должен дать инструмент. Который умеет только выполнять то, что человеку от него надо. А всё остальное он себе сам организует, и Шопена из динамиков, и Пруста из библиотеки.

Не надо считать себя умнее и духовнее рабочего человека. Пидорство это.

   

Дневник

главная