Редакторка, Яка Гарантує, Що Комп'ютери Розуміють Одне Одного

У світі технологій існують тисячі документів, що називаються специфікаціями.

In the world of technology, there are thousands of documents called specifications.

Специфікація, це письмова угода: вона каже кожному інженеру у світі точно, як система повинна поводитися.

A specification is a written agreement: it tells every engineer in the world exactly how a system should behave.

Якщо специфікація говорить, що певне повідомлення повинне закінчуватися крапкою, то кожен комп'ютер, який надсилає і отримує це повідомлення, мусить ставити крапку в кінці.

If a specification says that a certain message must end with a full stop, then every computer that sends and receives that message must put a full stop at the end.

Якщо навіть одне слово неоднозначне, тобто його можна прочитати двома різними способами, різні інженери побудують різні речі, і вони не працюватимуть разом.

If even one word is ambiguous, meaning it could be read two different ways, different engineers will build different things, and they will not work together.

Саме тут з'являється редактор на ім'я Сем.

That is where an editor named Sam comes in.

Сем, збірний персонаж, побудований із розповідей багатьох справжніх редакторів стандартів, що працюють за лаштунками інтернету.

Sam is a composite character, built from the stories of many real standards editors who work behind the scenes of the internet.

Сем мала досвід технічного письма і була найнята організацією зі стандартизації, таким комітетом, що пише правила того, як комп'ютери повинні спілкуватися.

Sam came from a technical-writing background and was hired by a standards body, the kind of committee that writes the rules for how computers should communicate.

Спочатку інженерні концепції були приголомшливими.

At first, the engineering concepts were overwhelming.

Але Сем навчилася запитувати: що трапиться, якщо хтось прочитає це речення по-іншому?

But Sam learned to ask: what happens if someone reads this sentence differently?

А що якщо читач зробить наголос на цьому слові замість того?

What if a reader emphasizes this word instead of that one?

А що якщо розробник пропустить цей розділ і перейде прямо до прикладу?

What if a developer skips this section and goes straight to the example?

Сем виявляла суперечності, які ховалися в документі роками.

Sam caught contradictions that had been hiding in the document for years.

Вона ввічливо, але рішуче боролася за окремі слова.

She fought politely but firmly over single words.

На одній нараді дискусія про те, чи писати must чи should, тривала три години.

In one meeting, a discussion about whether to write must or should lasted three hours.

Різниця здається невеликою: must означає правило, яке не можна порушити, а should правило, яке настійно рекомендується.

The difference seems small: must means a rule that cannot be broken, and should means a rule that is strongly advised.

Але помилка означає, що одні пристрої суворо дотримуватимуться правила, а інші ні, і тоді вони не зможуть спілкуватися між собою.

But getting it wrong means that some devices will follow the rule strictly and others will not, and then they cannot talk to each other.

Сем також малювала діаграми і писала приклади, прості і зрозумілі ілюстрації, що запобігали неправильній реалізації протоколу інженерами та марнуванню місяців роботи.

Sam also drew diagrams and wrote examples, simple and clear illustrations that prevented engineers from mis-implementing a protocol and wasting months of work.

Вона наставляла новачків у тому, що сама називала культурою ретельної специфікації.

She mentored newcomers in what she called the culture of careful specification.

Її ім'я не з'являється на жодному з продуктів, що використовують її роботу.

Her name appears on none of the products that use her work.

Але щоразу, коли браузер завантажує сторінку, або два телефони з'єднуються, або файл правильно відкривається на іншому комп'ютері, трохи ретельної мови Сема тихо працює всередині.

But every time a browser loads a page, or two phones connect, or a file opens correctly on a different computer, a little of Sam's careful language is working quietly inside it.

Мораль: Одне чітке слово, обране обережно, може запобігти тисячі непорозумінь.

Moral: A single clear word, chosen carefully, can prevent a thousand misunderstandings.