Агам

мой глаз нервно дёргается )

От слова ас, потому и с одной м ))

Но доклад вообще клёвый.

Про то, почему в мире беспроводных сетей ненадёжный UDP может быть надёжнее, чем надёжный TCP

Я часто советую писать просто и понятно для своей аудитории. Простоту можно оценить не только по своим ощущениям и во время  юзабилити-тестов, но и с помощью метрик и инструментов. Для этого пользуюсь readability.io: он оценивает текст по нескольким формулам и адаптирован для русского.

Джейкоб Нильсен советует целиться на уровень 8-классника в продуктах для широкой аудитории. И на уровень человека с высшим образованием — для B2B и в текстах для профессионалов.

Кто что думает?

Писал у себя тож об этом, всё так, в vscode легко встроить эту штуку remark'ом, можно настроить сколько алгоритмов дожны согласиться, что предложение "сложночитаемое", чтобы вылез ворнинг. Можно даже возраст читателя установить

Комрады, дайте совет. Есть два трейни техрайтера, нужно выбрать одного из них, какое дать им быстрое в исполнении и показательное в плане скилла задание?

сделать более понятной большую статью-свалку?

Де ж её взять-то? 😀

а вы там все понятно пишете и нет культурного слоя во внутренних доках?)

Надо поискать, но я бы еще опции послушал разные, не хочется чёт давать что-то по типу "инструкции к банкомату"

пусть покажут примеры документации, которую они хотят писать, когда вырастут

Хорошее предложение

Мне кажется было бы круто дать им какую-то демку вашего продукта (если есть) и попросить сделать краткий док на основе какой-то функциональности.
ну если у вас там не что-то слишком техническое для стажеров

тоже вариант

Решил всё же таким путём пойти, мне как раз вчера абракадабра прилетела по сборке электрон приложения на линух виндуз и макось от сотрудника прилетела, попрошу поправить её (сравню со своим результатом)

у яндекса тестовое задание переделать статью в википедии