Comments 25
... Или используй ChatGPT или другой инструмент, чтобы все уж точно знали, что ты - моднявый копирайтер и в тренде?
Звучит иронично, но совет дельный)) GPT умеет адаптироваться под нужный стиль изложения, в том числе можно попросить соблюдать ритмичность или не использовать длинные предложения.
А что, если мы пишем сугубо технический текст? Например:
Плата содержит асинхронный контроллер (UART), выполненный на чипе Asix AX99100, который поддерживает до четырех высокоскоростных последовательных портов. Развязка внешних цепей портов от управляющей схемы осуществляется интегральными приемопередатчиками ADM2582 c трансформаторной изоляцией и встроенными изолированными преобразователями напряжения питания. Приемопередатчики обеспечивают изоляцию с испытательным напряжением 2500 Вольт переменного тока (по методике UL 1577) и поддерживают скорости передачи данных до 10 Мбит/c.
- ну и так далее. Вышеприведённый текст скопирован из pdf-файла, который - я точно помню - был экспортирован из сплошного массива, написанного в ворде, а сейчас при вставке из него пришлось убрать лишние переводы строк.
Кстати, я вижу "литературные" недостатки этого текста, но мне нужно, чтобы он был достаточно формальным. Вопрос, как на это смотрят поисковые машины (для меня именно это главное).
Наверное тут нужно разделять тексты "для людей" и "чисто технические" тексты, которые читать не будет никто и никогда, ну или пока нечто описанное работает без сбоев.
если мы пишем сугубо технический текст
В приведенном вами примере я бы разбил кирпич текста буллетами. Т.е. сделал бы список из небольшого количества пунктов.
Это не 100% будет соответствовать описанной автором методе, но читаемость сильно повысится.
Мне кажется, нужно идти от цели: поисковые машины не оценят красоту и читабельность, поэтому для них лучше позаботиться о ключах, заспамленности и прочих технических штуках.
Но любопытства ради можно попробовать «нарезать» и технический текст. Например, первое предложение могло бы выглядеть так:
Плата содержит асинхронный контроллер (UART) на чипе Asix AX99100. Он поддерживает до четырех высокоскоростных последовательных портов.
Ну вот мне кажется, что такая подача информации отдаёт дилетантизмом. Ну то есть когда я такое читаю, то мне кажется, что это копирайтерский текст, а не авторский. Ну и потом, это ведь фрагмент описания изделия. Т.е. это не научно-популярный текст, а ориентированный на подготовленного читателя. Хотя, конечно, стараюсь не злоупотреблять длинными предложениями.
Сколь подготовленным бы ни был читатель, читать ТТХ в виде стены текста сложновато. Если цель - понравиться алгоритму ранжирования, то обратитесь к опыту профессионалов в этой области, переиспользовать знания о том, как писать тексты понятные человеку, там не выйдет. Если делать все-таки для людей, то стоит таки разбить описание на список пар "характеристика: значение" в формате карточки товара на маркетплейсе:
Поддержка последовательных интерфейсов:
- чип UART: Asix AX99100
- количество поддерживаемых последовательных портов: 4
- гальваническая развязка: ADM2582
- напряжение испытания изоляции: 2500 В (по методике UL 1577)
- максимальная скорость передачи данных: до 10Мбит/с
Cпасибо, раздел технических характеристик именно в такой форме там есть. Тут речь идёт о стиле вводного текста. В нём формулируются некоторые особенности изделия, например: "...контроллер может быть заказан как в полнопрофильном варианте (разъемы обоих портов расположены на одной монтажной планке), так и в низкопрофильном - для установки в корпуса SFF, flexATX и в корпуса для 19-дюймовой стойки высотой 2U" - ибо не всякий читатель разберётся, подходит ему изделие или нет, если мы просто укажем в характеристиках "монтажная планка: 120 или 79мм". Кстати, на одни лишь технические характеристики поисковые роботы наверное не ведутся. Я всё же надеюсь (хотя, возможно, и заблуждаюсь), что наши изделия попадают на первую страницу выдачи яндекса именно потому что у нас есть вводный текст "в свободной форме", а у конкурентов, как правило, нет.
Вопрос, однако, в том, не покажется ли утомительным текст для поискового робота: возможно, слишком объёмный текст будет спущен вниз в поисковой выдаче?
И вообще, как к приведённым в статье тезисам относятся поисковые машины?
Если ориентироваться на официальные рекомендации, то скорее положительно. Обычно поисковики призывают не оглядываться на алгоритмы, а сфокусироваться именно на читателе. Но лично мой опыт показывает, что «технические» показатели текста не менее важны. Решение столько же очевидное, сколько непростое, — тестировать и сравнивать результаты.
Астанавитесь!
Для такой информации уже давно придумали таблицы, хватит писать предложения.
Уже реально бесит)
В данном случае Вы заблуждаетесь. Мне, как разработчику изделия, виднее, какие факты о нём изложить предложениями, а какие свести в таблицу характеристик. А то представьте, например:
<UL>
<LI> Наименование: миксер
<LI> Тип области применения: кухонный
<LI>Назначение: перемешивание продуктов питания
<LI>Тип привода: двухвальный
<LI>Метод перемешивания: насадками
</UL> и так далее...
Мне, как разработчику изделия, виднее, какие факты о нём изложить предложениями, а какие свести в таблицу характеристик
Я не понимаю цепочки рассуждений, стоящих за этим утверждением. Это какая-то бессмыслица.
Продукты (изделия, текст, etc) надо делать так, чтобы её понимал потребитель, а не производитель. Поэтому делать документацию надо не так, как подсказывают вам ваши личные эстетические ощущения, а так, как будет удобнее потребителю документации, т.е. мне))
А то представьте, например
Несмотря на то, что вёрстка ваша поехала, смысл я понял. И да - это просто крекрасный формат был бы.
Спасибо, обязательно приму к сведению. ))
...жаль, что на 25-м году работы в индустрии я, оказывается, генерирую бессмыслицу ((
Количество лет вообще ни на что не влияет, если нет обратной связи или вы эту обратную связь игнорируете)
Конечно игнорируем, иначе бы наверное 20+ лет не продержались в этом бизнесе )))
Так может товар ваш настолько хорош, что все забивают на неудобства в документации :) Или просто за 20+ лет привыкли)
Одно на другое может и не влияет никак в коммерческом смысле, но это не значит, что нельзя делать лучше)
Никогда не попадали в ситуацию, что видите где-то (в каталоге например) какую-то штуковину и пытаетесь понять, что это вообще такое и для чего оно надо? А с такой сущностью, как "даташит" не сталкивались? Вот, например,
https://static.chipdip.ru/lib/379/DOC040379621.pdf , см. раздел 2 и 3.
Я утверждаю, что любой даташит от TI - это образец того, как надо делать даташиты. На них все остальные равняются...Обратите внимание, что оглавление идёт уже после перечисления особенностей и краткого описания. Ещё датабрифы есть, например https://docs.broadcom.com/docs/12351844, это когда изделие настолько сложное, что даташит занимает под 800 страниц.
Mой примерно 20-летний опыт показывает, что покупатели, которые применяют нашу продукцию, часто не обладают должными специальными знаниями, чтобы начинать описание изделия сразу с таблицы характеристик. Нужно их (покупателей) элегантно ввести в курс дела, чтобы, читая дальше, они могли ориентироваться, по каким характеристикам оценивать, подходит изделие для их целей или нет. Например: "Дополнительное питание (12V) для адаптера M.2/PCI-E, требуемое для работы большинства плат PCI Express, подается от источника питания питания компьютера через разъем, унифицированный с разъемом FDD."
Здесь выделено жирным то, чего потребитель может не знать и не придать значения наличию/отсутствию этой возможности в товаре. Или: "Адаптер можно установить в разъем M2 c ключом B или M, предназначенный для устройств, работающих по PCI Express. Работа в разъеме, предназначенном для SSD M.2 SATA, невозможна". Если это подать только в таблице характеристик ("Подключение: М2 key B/M (PCI-E); SATA: несовместимо" ), то очень вероятно, что читатель просто не поймёт, на что ему нужно обратить внимание и какие свойства своего оборудования уточнить перед заказом...
главное промт написать не коряво, а то никаких нервов не хватит, чтобы объяснить чат гпт, что тебе в итоге-то нужно
❌ Она начала ругаться с оператором, чтобы получить деньги за сгоревшие бонусы, которые, кстати говоря, ей обещали ещё в прошлом месяце.
✅ Она начала ругаться с оператором, чтобы получить деньги за сгоревшие бонусы. Их обещали зачислить ещё в прошлом месяце.
Мне кажется, что в обоих случаях немного потеряна мысль. Что обещали зачислить "еще в прошлом месяце": деньги или бонусы?
каждый в любом случае напишет ,то как будет видеть и как ему придёт в голову та или иная мысль
Очень понятно и лаконично объясняет основы написания предложений. Я получил много полезных советов и теперь чувствую себя увереннее в своих писательских способностях.
Если ты не копирайтер, но нужно что-то написать: ну очень простые правила про предложения