Size: a a a

technicalwriters

2020 November 27

А

Александр Мокрушин... in technicalwriters
Cro Vin
Спасибо за мнение!

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

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

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

CV

Cro Vin in technicalwriters
Александр Мокрушин
Я думаю, что не всегда стоит описывать сообщения об ошибках.  Пример органично смотрится без упоминания о ней.

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

SR

Stas Rychkov in technicalwriters
Cro Vin
В свежей статье «Как сделать текст легче» на одном популярном ресурсе приводится пример переделки текста из «сложного» в «простой».

Было

Для обновления, нужно временно скопировать файл «Ф» на компьютер с ПО, обновить программой «П» (указать путь к файлу «Ф»), затем скопировать файл обратно на сетевой ресурс. Перед началом обновления, необходимо убедиться в достаточном количестве свободного места на диске, где расположен файл «Ф», – это необходимо для создания резервной копии. Объём свободного места должен быть не менее размера обновляемого файла. Если свободного места недостаточно, программа выведет соответствующее сообщение.

Стало

Обновление

1 Убедитесь, что на диске, где расположен файл «Ф», достаточно места для создания резервной копии.
2 Скопируйте файл «Ф» из сетевого хранилища на компьютер с программой «П»
3 В программе «П» укажите путь к файлу «Ф» и обновите его.
4 Скопируйте обновленный файл «Ф» обратно в сетевое хранилище.

Как бы Вы переделали его и в чем недостаток предложенного варианта в статье?

(Интересен опыт «стилистических» лайфхаков)
Абстрактно редактура хороша.
Если быть въедливым, наверное нужно понять аудиторию и формат. Тогда будет ясно, уместно ли переделывать повествование в инструкцию, и нужны ли подробности о сообщениях об ошибке.

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

MS

Maria Shabanova in technicalwriters
источник
2020 November 28

АП

Александр Парень... in technicalwriters
Чего-то в ступор попал. Где правда братцы?

HTTP-авторизация или HTTP авторизация?
источник

FM

Fox Mulder in technicalwriters
Http-авторизация
источник

АП

Александр Парень... in technicalwriters
Htto очепатка? :)
источник

АП

Александр Парень... in technicalwriters
Агась )
источник

АП

Александр Парень... in technicalwriters
Спасиб
источник

FM

Fox Mulder in technicalwriters
OAuth-авторизация — Технологии Яндекса
https://yandex.ru/dev/oauth?turbo=true
источник

FM

Fox Mulder in technicalwriters
Вот как яндекс это делает. Тут правда не http, но сути не меняет
источник

АП

Александр Парень... in technicalwriters
Да, здорово, есть на кого ориентироваться.
источник

FM

Fox Mulder in technicalwriters
HttpWebRequest.PreAuthenticate Свойство (System.Net) | Microsoft Docs
https://docs.microsoft.com/ru-ru/dotnet/api/system.net.httpwebrequest.preauthenticate
источник

FM

Fox Mulder in technicalwriters
А вот майкрософт пишет уже авторизация http. Я бы ориентировался на вариант мягких
источник

M

Maeg in technicalwriters
Александр Парень
Да, здорово, есть на кого ориентироваться.
Я бы ориентировалась на справочное бюро gramota.ru всё же :)
источник

FM

Fox Mulder in technicalwriters
У них есть, пример, http-запрос. Это даёт нам право ставит дефис после http
источник

FM

Fox Mulder in technicalwriters
Я бы ориентировалась на справочное бюро gramota.ru всё же :)
Насколько их портал адаптирован под современное ИТ?
источник

FM

Fox Mulder in technicalwriters
Я бы больше доверял майкрософту
источник

M

Maeg in technicalwriters
Fox Mulder
Я бы ориентировалась на справочное бюро gramota.ru всё же :)
Насколько их портал адаптирован под современное ИТ?
Они довольно внимательно отслеживают и фиксируют новое. Когда ещё нет нормы, то так об этом и пишут. Вот, напрмер, по исходному примеру: http://new.gramota.ru/spravka/buro/search-answer?s=266053
источник

FM

Fox Mulder in technicalwriters
Круто! Молодцы они
источник