🔍 Начните печатать, чтобы искать по книге или перейти к нужной странице по номеру

Удобно листать не только прокруткой, но и клавишами‑стрелками:

 
между важными местами
Shift
между
разворотами
Мак­сим Илья­хов

Информационный стиль

Изда­тель­ство Бюро Гор­бу­нова
2016
удк 811.161.1
ббк 81.2Рус‑2
И49
Илья­хов М. О.
И49
Инфор­ма­ци­он­ный стиль. —
М.: Изд‑во Бюро Гор­бу­нова, 2016
ISBN 978‑5‑9907024‑2‑4

Представ­ля­ем прак­ти­че­ское руко­вод­ство по редак­ту­ре тек­ста в инфор­ма­ци­он­ном сти­ле. Учеб­ник пред­на­зна­чен для писа­те­лей, редак­то­ров, дизай­не­ров, раз­ра­бот­чи­ков и менеджеров.

УДК 811.161.1
ББК 81.2Рус‑2

Оглавление

Скрыто 154 разворота

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

Прин­ципы оформ­ле­ния кода напи­саны враз­но­бой: одни в пове­ли­тель­ном накло­не­нии, дру­гие — от тре­тьего лица. Есть даже пред­ло­же­ние, в кото­ром по отно­ше­нию к чита­телю одно­вре­менно исполь­зу­ется и тре­тье лицо, и пове­ли­тель­ное наклонение.

Сами абзацы тоже плохо струк­ту­ри­ро­ваны: где‑то они начи­на­ются с клю­че­вых слов, будто это под­за­го­ловки; где‑то — с пове­ли­тель­ного наклонения.

Попро­буем при­ве­сти этот мани­фест в порядок.

Прин­ципы оформ­ле­ния кода

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

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

Пустые строки. Функ­ции верх­него уровня и опре­де­ле­ния клас­сов отби­ва­ются двумя пустыми стро­ками. Методы внутри класса отби­ва­ются одной пустой стро­кой. Исполь­зуйте пустые строки экономно.

Язык поз­во­ляет оди­на­ково рав­но­ценно исполь­зо­вать оди­нар­ные и двой­ные кавычки. Выбе­рите что‑то одно и исполь­зуйте после­до­ва­тельно. Если у раз­ра­бот­чика есть выбор, сме­нить фор­мат кавы­чек или экра­ни­ро­вать кавычки внутри строки, лучше сме­ните фор­мат: экра­ни­ро­ва­ние хуже читается.

Лиш­ние про­белы — внутри ско­бок, перед запя­той, точ­кой с запя­тойли двое­то­чия. Про­белы нужны вокруг операторов.

Прин­ципы оформ­ле­ния кода

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

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

Пустые строки. Функ­ции верх­него уровня и опре­де­ле­ния клас­сов отби­ва­ются двумя пустыми стро­ками. Методы внутри класса отби­ва­ются одной пустой стро­кой. Исполь­зуйте пустые строки экономно.

Язык поз­во­ляет оди­на­ково рав­но­ценно исполь­зо­вать оди­нар­ные и двой­ные кавычки. Выбе­рите что‑то одно и исполь­зуйте после­до­ва­тельно. Если у раз­ра­бот­чика есть выбор, сме­нить фор­мат кавы­чек или экра­ни­ро­вать кавычки внутри строки, лучше сме­ните фор­мат: экра­ни­ро­ва­ние хуже читается.

Лиш­ние про­белы — внутри ско­бок, перед запя­той, точ­кой с запя­тойли двое­то­чия. Про­белы нужны вокруг операторов.

Прин­ципы оформ­ле­ния кода

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

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

Пустые строки. Функ­ции верх­него уровня и опре­де­ле­ния клас­сов отби­ва­ются двумя пустыми стро­ками. Методы внутри класса отби­ва­ются одной пустой стро­кой. Исполь­зуйте пустые строки экономно.

Язык поз­во­ляет оди­на­ково рав­но­ценно исполь­зо­вать оди­нар­ные и двой­ные кавычки. Выбе­рите что‑то одно и исполь­зуйте после­до­ва­тельно. Если у раз­ра­бот­чика есть выбор, сме­нить фор­мат кавы­чек или экра­ни­ро­вать кавычки внутри строки, лучше сме­ните фор­мат: экра­ни­ро­ва­ние хуже читается.

Лиш­ние про­белы — внутри ско­бок, перед запя­той, точ­кой с запя­тойли двое­то­чия. Про­белы нужны вокруг операторов.

Прин­ципы оформ­ле­ния кода

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

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

Пустые строки. Функ­ции верх­него уровня и опре­де­ле­ния клас­сов отби­ва­ются двумя пустыми стро­ками. Методы внутри класса отби­ва­ются одной пустой стро­кой. Исполь­зуйте пустые строки экономно.

Язык поз­во­ляет оди­на­ково рав­но­ценно исполь­зо­вать оди­нар­ные и двой­ные кавычки. Выбе­рите что‑то одно и исполь­зуйте после­до­ва­тельно. Если у раз­ра­бот­чика есть выбор, сме­нить фор­мат кавы­чек или экра­ни­ро­вать кавычки внутри строки, лучше сме­ните фор­мат: экра­ни­ро­ва­ние хуже читается.

Лиш­ние про­белы — внутри ско­бок, перед запя­той, точ­кой с запя­тойли двое­то­чия. Про­белы нужны вокруг операторов.

Прин­ципы оформ­ле­ния кода

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

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

Пустые строки. Функ­ции верх­него уровня и опре­де­ле­ния клас­сов отби­ва­ются двумя пустыми стро­ками. Методы внутри класса отби­ва­ются одной пустой стро­кой. Исполь­зуйте пустые строки экономно.

Язык поз­во­ляет оди­на­ково рав­но­ценно исполь­зо­вать оди­нар­ные и двой­ные кавычки. Выбе­рите что‑то одно и исполь­зуйте после­до­ва­тельно. Если у раз­ра­бот­чика есть выбор, сме­нить фор­мат кавы­чек или экра­ни­ро­вать кавычки внутри строки, лучше сме­ните фор­мат: экра­ни­ро­ва­ние хуже читается.

Лиш­ние про­белы — внутри ско­бок, перед запя­той, точ­кой с запя­тойли двое­то­чия. Про­белы нужны вокруг операторов.

Прин­ципы оформ­ле­ния кода

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

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

Пустые строки. Функ­ции верх­него уровня и опре­де­ле­ния клас­сов отби­ва­ются двумя пустыми стро­ками. Методы внутри класса отби­ва­ются одной пустой стро­кой. Исполь­зуйте пустые строки экономно.

Язык поз­во­ляет оди­на­ково рав­но­ценно исполь­зо­вать оди­нар­ные и двой­ные кавычки. Выбе­рите что‑то одно и исполь­зуйте после­до­ва­тельно. Если у раз­ра­бот­чика есть выбор, сме­нить фор­мат кавы­чек или экра­ни­ро­вать кавычки внутри строки, лучше сме­ните фор­мат: экра­ни­ро­ва­ние хуже читается.

Лиш­ние про­белы — внутри ско­бок, перед запя­той, точ­кой с запя­тойли двое­то­чия. Про­белы нужны вокруг операторов.

Чтобы при­ве­сти в поря­док этот текст, возь­мём за основу еди­ную струк­туру для каж­дого правила:

Прин­цип — утверждение

Реко­мен­да­ция — пове­ли­тель­ное наклонение

Объ­яс­не­ние — в сво­бод­ной форме, по желанию

При­ме­ним струк­туру к пер­вому абзацу тек­ста: прин­цип, реко­мен­да­ция, объяснение.

Рас­про­стра­ним на все абзацы.

Прин­ципы‑утвер­жде­ния в начале абза­цев не согла­со­ваны. Хочется при­ве­сти их к еди­ному фор­мату и сде­лать более звонкими.

Пер­вый вари­ант — пре­вра­тить все прин­ципы в выра­же­ния с гла­го­лом в неопре­де­лён­ной форме. Полу­ча­ется что‑то вроде сове­тов, но не везде это выгля­дит элегантно.

Дру­гой вари­ант — обо­зна­чить, о чём пра­вило. Выгля­дит элегантнее.

В двух абза­цах после основ­ного совета есть исклю­че­ния. Зада­димся вопро­сом: какие исклю­че­ния у дру­гих пра­вил? Общая для всех пра­вил струк­тура помо­жет нам уви­деть белые пятна.

Теперь все пра­вила орга­ни­зо­ваны единообразно:

Клю­че­вое слово — существительное

Совет — пове­ли­тель­ное наклонение

Исклю­че­ние — пове­ли­тель­ное наклонение

Объ­яс­не­ние — в сво­бод­ной форме, по желанию

Прин­ципы оформ­ле­ния кода

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

Отсту­пайте только 4 про­бе­лами. Отсту­пать табу­ля­цией можно только тогда, когда осталь­ной код уже напи­сан с табу­ля­цией и воз­ни­кает вопрос совместимости.

Пустые строки. Функ­ции верх­него уровня и опре­де­ле­ния клас­сов отби­ва­ются двумя пустыми стро­ками. Методы внутри класса отби­ва­ются одной пустой стро­кой. Исполь­зуйте пустые строки экономно.

Язык поз­во­ляет оди­на­ково рав­но­ценно исполь­зо­вать оди­нар­ные и двой­ные кавычки. Выбе­рите что‑то одно и исполь­зуйте после­до­ва­тельно. Если у раз­ра­бот­чика стоит выбор, сме­нить фор­мат кавы­чек или экра­ни­ро­вать кавычки внутри строки, лучше сме­ните фор­мат: экра­ни­ро­ва­ние хуже читается.

Лиш­ние про­белы — внутри ско­бок, перед запя­той, точ­кой с запя­той или двое­то­чия. Про­белы нужны вокруг операторов.

Прин­ципы оформ­ле­ния кода

Чита­е­мость важна. Пишите код так, чтобы его было удобно читать незна­ко­мым людям. Код читают чаще, чем пишут.

Отсту­пайте только 4 про­бе­лами. Отсту­пать табу­ля­цией можно только тогда, когда осталь­ной код уже напи­сан с табу­ля­цией и воз­ни­кает вопрос совместимости.

Пустые строки. Функ­ции верх­него уровня и опре­де­ле­ния клас­сов отби­ва­ются двумя пустыми стро­ками. Методы внутри класса отби­ва­ются одной пустой стро­кой. Исполь­зуйте пустые строки экономно.

Язык поз­во­ляет оди­на­ково рав­но­ценно исполь­зо­вать оди­нар­ные и двой­ные кавычки. Выбе­рите что‑то одно и исполь­зуйте после­до­ва­тельно. Если у раз­ра­бот­чика стоит выбор, сме­нить фор­мат кавы­чек или экра­ни­ро­вать кавычки внутри строки, лучше сме­ните фор­мат: экра­ни­ро­ва­ние хуже читается.

Лиш­ние про­белы — внутри ско­бок, перед запя­той, точ­кой с запя­той или двое­то­чия. Про­белы нужны вокруг операторов.

Прин­ципы оформ­ле­ния кода

Чита­е­мость важна. Пишите код так, чтобы его было удобно читать незна­ко­мым людям. Код читают чаще, чем пишут.

Отсту­пайте только 4 про­бе­лами. Отсту­пать табу­ля­цией можно только тогда, когда осталь­ной код уже напи­сан с табу­ля­цией и воз­ни­кает вопрос совместимости.

Пустые строки. Функ­ции верх­него уровня и опре­де­ле­ния клас­сов отби­ва­ются двумя пустыми стро­ками. Методы внутри класса отби­ва­ются одной пустой стро­кой. Исполь­зуйте пустые строки экономно.

Язык поз­во­ляет оди­на­ково рав­но­ценно исполь­зо­вать оди­нар­ные и двой­ные кавычки. Выбе­рите что‑то одно и исполь­зуйте после­до­ва­тельно. Если у раз­ра­бот­чика стоит выбор, сме­нить фор­мат кавы­чек или экра­ни­ро­вать кавычки внутри строки, лучше сме­ните фор­мат: экра­ни­ро­ва­ние хуже читается.

Лиш­ние про­белы — внутри ско­бок, перед запя­той, точ­кой с запя­той или двое­то­чия. Про­белы нужны вокруг операторов.

Прин­ципы оформ­ле­ния кода

Чита­е­мость важна. Пишите код так, чтобы его было удобно читать незна­ко­мым людям. Код читают чаще, чем пишут.

Отсту­пайте только 4 про­бе­лами. Отсту­пать табу­ля­цией можно только тогда, когда осталь­ной код уже напи­сан с табу­ля­цией и воз­ни­кает вопрос совместимости.

Пустые строки. Функ­ции верх­него уровня и опре­де­ле­ния клас­сов отби­ва­ются двумя пустыми стро­ками. Методы внутри класса отби­ва­ются одной пустой стро­кой. Исполь­зуйте пустые строки экономно.

Язык поз­во­ляет оди­на­ково рав­но­ценно исполь­зо­вать оди­нар­ные и двой­ные кавычки. Выбе­рите что‑то одно и исполь­зуйте после­до­ва­тельно. Если у раз­ра­бот­чика стоит выбор, сме­нить фор­мат кавы­чек или экра­ни­ро­вать кавычки внутри строки, лучше сме­ните фор­мат: экра­ни­ро­ва­ние хуже читается.

Лиш­ние про­белы — внутри ско­бок, перед запя­той, точ­кой с запя­той или двое­то­чия. Про­белы нужны вокруг операторов.

Прин­ципы оформ­ле­ния кода

Чита­е­мость важна. Пишите код так, чтобы его было удобно читать незна­ко­мым людям. Код читают чаще, чем пишут.

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

Пустые строки. Функ­ции верх­него уровня и опре­де­ле­ния клас­сов отби­ва­ются двумя пустыми стро­ками. Методы внутри класса отби­ва­ются одной пустой стро­кой. Исполь­зуйте пустые строки экономно.

Язык поз­во­ляет оди­на­ково рав­но­ценно исполь­зо­вать оди­нар­ные и двой­ные кавычки. Выбе­рите что‑то одно и исполь­зуйте после­до­ва­тельно. Если у раз­ра­бот­чика стоит выбор, сме­нить фор­мат кавы­чек или экра­ни­ро­вать кавычки внутри строки, лучше сме­ните фор­мат: экра­ни­ро­ва­ние хуже читается.

Лиш­ние про­белы — внутри ско­бок, перед запя­той, точ­кой с запя­той или двое­то­чия. Про­белы нужны вокруг операторов.

Прин­ципы оформ­ле­ния кода

Чита­е­мость важна. Пишите код так, чтобы его было удобно читать незна­ко­мым людям. Код читают чаще, чем пишут.

Отступ — 4 про­бела. Отсту­пайте табу­ля­цией только тогда, когда осталь­ной код уже напи­сан с табу­ля­цией и воз­ни­кает вопрос сов­ме­сти­мо­сти. В осталь­ных слу­чаях отсту­пайте пробелами.

Эко­но­мить пустые строки. Функ­ции верх­него уровня и опре­де­ле­ния клас­сов отби­вайте двумя пустыми стро­ками, методы внутри класса — одной. Пустые строки — инстру­мент смыс­ло­вого деле­ния кода.

Одни кавычки навсе­гда. Для строк выбе­рите оди­нар­ные или двой­ные кавычки и исполь­зуйте после­до­ва­тельно. Если у вас стоит выбор, сме­нить фор­мат кавы­чек или экра­ни­ро­вать кавычки внутри строки, сме­ните фор­мат: экра­ни­ро­ва­ние хуже читается.

Сле­дить за про­бе­лами. Не ставьте про­белы внутри ско­бок, перед запя­той, точ­кой с запя­той или двое­то­чия; ставьте — вокруг опе­ра­то­ров. Про­белы должны исполь­зо­ваться последовательно.

Прин­ципы оформ­ле­ния кода

Чита­е­мость важна. Пишите код так, чтобы его было удобно читать незна­ко­мым людям. Код читают чаще, чем пишут.

Отступ — 4 про­бела. Отсту­пайте табу­ля­цией только тогда, когда осталь­ной код уже напи­сан с табу­ля­цией и воз­ни­кает вопрос сов­ме­сти­мо­сти. В осталь­ных слу­чаях отсту­пайте пробелами.

Эко­но­мить пустые строки. Функ­ции верх­него уровня и опре­де­ле­ния клас­сов отби­вайте двумя пустыми стро­ками, методы внутри класса — одной. Пустые строки — инстру­мент смыс­ло­вого деле­ния кода.

Одни кавычки навсе­гда. Для строк выбе­рите оди­нар­ные или двой­ные кавычки и исполь­зуйте после­до­ва­тельно. Если у вас стоит выбор, сме­нить фор­мат кавы­чек или экра­ни­ро­вать кавычки внутри строки, сме­ните фор­мат: экра­ни­ро­ва­ние хуже читается.

Сле­дить за про­бе­лами. Не ставьте про­белы внутри ско­бок, перед запя­той, точ­кой с запя­той или двое­то­чия; ставьте вокруг опе­ра­то­ров. Про­белы должны исполь­зо­ваться последовательно.

Прин­ципы оформ­ле­ния кода

Сле­дить за чита­е­мо­стью. Пишите код так, чтобы его было удобно читать незна­ко­мым людям. Код читают чаще, чем пишут.

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

Эко­но­мить пустые строки. Функ­ции верх­него уровня и опре­де­ле­ния клас­сов отби­вайте двумя пустыми стро­ками, методы внутри класса — одной. Пустые строки — инстру­мент смыс­ло­вого деле­ния кода.

Исполь­зо­вать одни кавычки. Для строк выбе­рите оди­нар­ные или двой­ные кавычки и исполь­зуйте после­до­ва­тельно. Если у вас стоит выбор, сме­нить фор­мат кавы­чек или экра­ни­ро­вать кавычки внутри строки, сме­ните фор­мат: экра­ни­ро­ва­ние хуже читается.

Сле­дить за про­бе­лами. Не ставьте про­белы внутри ско­бок, перед запя­той, точ­кой с запя­той или двое­то­чия; ставьте вокруг опе­ра­то­ров. Про­белы должны исполь­зо­ваться последовательно.

Прин­ципы оформ­ле­ния кода

Чита­е­мость. Пишите код так, чтобы его было удобно читать незна­ко­мым людям. Код читают чаще, чем пишут.

Отступы. Отсту­пайте 4 про­бе­лами. Исполь­зуйте табу­ля­цию только тогда, когда осталь­ной код уже напи­сан с табу­ля­цией и воз­ни­кает вопрос сов­ме­сти­мо­сти. В осталь­ных слу­чаях отсту­пайте пробелами.

Пустые строки. Функ­ции верх­него уровня и опре­де­ле­ния клас­сов отби­вайте двумя пустыми стро­ками, методы внутри класса — одной. Пустые строки — инстру­мент смыс­ло­вого деле­ния кода.

Кавычки. Для строк выбе­рите оди­нар­ные или двой­ные кавычки и исполь­зуйте после­до­ва­тельно. Если у вас стоит выбор, сме­нить фор­мат кавы­чек или экра­ни­ро­вать кавычки внутри строки, сме­ните фор­мат: экра­ни­ро­ва­ние хуже читается.

Про­белы. Не ставьте внутри ско­бок, перед запя­той, точ­кой с запя­тойли двое­то­чия; ставьте вокруг опе­ра­то­ров. Про­белы должны исполь­зо­ваться последовательно.

Прин­ципы оформ­ле­ния кода

Чита­е­мость. Пишите код так, чтобы его было удобно читать незна­ко­мым людям. Код читают чаще, чем пишут.

Отступы. Отсту­пайте 4 про­бе­лами. Исполь­зуйте табу­ля­цию только тогда, когда осталь­ной код уже напи­сан с табу­ля­цией и воз­ни­кает вопрос сов­ме­сти­мо­сти. В осталь­ных слу­чаях отсту­пайте пробелами.

Пустые строки. Функ­ции верх­него уровня и опре­де­ле­ния клас­сов отби­вайте двумя пустыми стро­ками, методы внутри класса — одной. Пустые строки — инстру­мент смыс­ло­вого деле­ния кода.

Кавычки. Для строк выбе­рите оди­нар­ные или двой­ные кавычки и исполь­зуйте после­до­ва­тельно. Если у вас стоит выбор, сме­нить фор­мат кавы­чек или экра­ни­ро­вать кавычки внутри строки, сме­ните фор­мат: экра­ни­ро­ва­ние хуже читается.

Про­белы. Не ставьте про­белы внутри ско­бок, перед запя­той, точ­кой с запя­той или двое­то­чия; ставьте вокруг опе­ра­то­ров. Про­белы должны исполь­зо­ваться последовательно.

Прин­ципы оформ­ле­ния кода

Чита­е­мость. Пишите код так, чтобы его было удобно читать незна­ко­мым людям. Если чита­е­мость вре­дит ско­ро­сти раз­ра­ботки, всё равно выби­райте чита­е­мость. Вы пишете код один раз, а после вас его читают десятки раз.

Отступы. Отсту­пайте 4 про­бе­лами. Исполь­зуйте табу­ля­цию только тогда, когда осталь­ной код уже напи­сан с табу­ля­цией и воз­ни­кает вопрос сов­ме­сти­мо­сти. В осталь­ных слу­чаях отсту­пайте пробелами.

Пустые строки. Функ­ции верх­него уровня и опре­де­ле­ния клас­сов отби­вайте двумя пустыми стро­ками, методы внутри класса — одной. В край­нем слу­чае отби­вайте смыс­ло­вые блоки функ­ций двумя стро­ками. Пустые строки — инстру­мент смыс­ло­вого деле­ния кода.

Кавычки. Для строк выбе­рите оди­нар­ные или двой­ные кавычки и исполь­зуйте после­до­ва­тельно. Если у вас стоит выбор, сме­нить фор­мат кавы­чек или экра­ни­ро­вать кавычки внутри строки, сме­ните фор­мат: экра­ни­ро­ва­ние хуже читается.

Про­белы. Не ставьте про­белы внутри ско­бок, перед запя­той, точ­кой с запя­той или двое­то­чия; ставьте вокруг опе­ра­то­ров. В слож­ных ситу­а­циях посту­пайте последовательно.

Заголовок

В уст­ной речи у автора нет эле­гант­ного спо­соба обо­зна­чить тему рас­сказа. Он вынуж­ден гово­рить «а теперь мы перей­дём к...» или «рас­смот­рим такую‑то тему». Это неиз­бежно в лек­ции или на лич­ной встрече, но на письме легче вос­поль­зо­ваться заголовком.

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

Редак­тор дол­жен стре­миться поста­вить заго­ло­вок к ста­тье, про­мо­стра­нице, тек­сту о себе, пуб­ли­ка­ции в Фейс­буке, даже к СМС или пуш‑уве­дом­ле­нию. Это не только сде­лает текст при­вле­ка­тель­нее, но и сра­бо­тает как про­верка: если редак­тор не может подо­брать заго­ло­вок, то у тек­ста про­блема со струк­ту­рой и логикой.

Всегда ставьте заголовки

Заго­ло­вок помо­гает при­влечь вни­ма­ние к тек­сту или его части. Корот­кий текст, набран­ный бóльшим кег­лем или жир­ным начер­та­нием и сто­я­щий на отдель­ной строке, выгля­дит как заго­ло­вок. Чита­тель обра­щает на него вни­ма­ние автоматически.

Несмотря на то, что обычно мы читаем слева направо, на этом раз­во­роте вы сна­чала позна­ко­ми­лись с при­ме­ром справа. Мощ­ный круп­ный заго­ло­вок пере­тя­нул на себя вни­ма­ние и нару­шил есте­ствен­ный поря­док чтения.

Однако замет­ным заго­ло­вок делает не раз­мер, не жир­ность, а кон­траст с обыч­ным тек­стом. Если набрать весь текст крупно, кон­траст про­па­дёт и текст пере­ста­нет быть привлекательным.

Про­ек­ти­руйте заго­ловки так, чтобы чита­тель на них отды­хал. Доста­точно поста­вить заго­ло­вок к ста­тье и раз­бав­лять её под­за­го­лов­ками после каж­дых 7⁠—10 абза­цев текста.

Если ста­вить заго­ловки слиш­ком часто, чита­тель уста­нет от смены формата.

Сначала вы прочитаете это

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

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

Дайте гла­зам отдохнуть

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

Не ставьте заголовки слишком часто

Хорошо спро­ек­ти­ро­ван­ный заго­ло­вок даёт чита­телю отдохнуть.

Избе­гайте конфликтов

Заго­ловки не должны кон­флик­то­вать друг с дру­гом и основ­ным текстом.

Корот­кий и контрастный

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

Это отвлекает

Слиш­ком длин­ные и частые заго­ловки будут мешать.

И от этого устаёшь

Чте­ние и так слож­ный про­цесс. Каж­дый раз, когда чита­телю при­дется пере­клю­чаться на дру­гой фор­мат тек­ста, он будет совер­шать допол­ни­тель­ные усилия.

Окру­жайте заго­ло­вок текстом

Сле­дите, чтобы заго­ловки не сто­яли слиш­ком близко.

В выпус­ках ново­стей на радио исполь­зуют пред­ва­ри­тельно запи­сан­ные голо­со­вые вставки — они выпол­няют роль заго­лов­ков. Обычно они выби­ва­ются из общего потока речи: напри­мер, ново­сти читает девушка, а вставки запи­сал муж­чина. За счёт непо­хо­же­сти слу­ша­тель отли­чает их и на лету выхва­ты­вает струк­туру рассказа.

...и засу­нуть себе

куда подальше

заявил вице-президент.

Дру­гие сотрудники

от комментариев

отказались.

О погоде!

В Москве солнечно,

без осадков,

температура плюс двадцать два

градуса.

О пробках!

Плотно стоит

тре­тье кольцо

в обоих направлениях.

Скрыто 77 разворотов

Илья­хов Мак­сим Олегович

Инфор­ма­ци­он­ный стиль

  • Арт‑дирек­тор и изда­тель Артём Горбунов

  • Иллю­стра­тор Андрей Кокорин

  • Дизай­нер обложки Вла­ди­мир Колпаков

  • Раз­ра­бот­чики Рустам Кул­ма­тов,
    и Васи­лий Половнёв

  • Тести­ров­щик Сер­гей Фролов

  • Книга набрана шриф­тами
    «Бюро­се­риф» и «Бюросанс»

  • Дизайн‑бюро Артёма Гор­бу­нова
    Большая Новодмитровская улица,
    дом 36, стро­е­ние 2
    Москва, Рос­сия, 127015