вы все еще про документацию? :)

When it's bad, it's even worse than nothing.

На самом деле, такие вопросы задаются человеку, претендующему минимум на Senior Technical Writer. При этом такие вопросы обычно задаются на собеседовании, чтобы посмотреть как кандидат отвечает, как он мыслит. Также предполагается, что кандидат будет активно задавать вопросы, уточняющие ТЗ. Т.е. количествo assumptions при НЕинтерактиве настолько увеличивается, что теряется всякий смысл этого задания. От меня вопрос: а какие наводящие вопросы вы сами задавали тем, кто вам предоставил тестовое задание? Или каким образом они вам предлагают задавать возникающие вопросы?

Ну ладно, про большинство я, пожалуй, загнул:)

Но порядочная часть наших клиентов приходит с запросами типа «нам стыдно за свою документацию» или «она совсем не радует, и мы не знаем, как ее улучшить»

Претендую я на должность Junior Technical Writer. Задание мне прислала HR, о том, кому адресовать вопросы вообще ничего сказано не было)

Некоторое время назад мы блог писали про то, как выбирать систему документации:
https://clickhelp.com/clickhelp-technical-writing-blog/choosing-a-technical-writing-tool/

Писать про это можно бесконечно, так как требования и цели у всех разные. Но тот пост, по крайней мере, касался online tools, что в Вашем случае наверное будет релевантно (так как продукт SaaS). Надеюсь, хоть чем-то поможет - может, возьмёте оттуда базовый список критериев, или свой расширите. Удачи!

Спасибо!

Может вы пошлете им письмо с вопросами. Тем самым покажете, что вы уже в чем-то шарите :) Например, кто product owner документации; от кого приходят реквексты на создание/изменение документов; какая система контроля версий используется; какой текущий workflow, есть ли qa документации и кто в этом участвует. Если честно, то если меня иногда спрашивают "какую систему выбрать", то в ответ было обычно задается порядка 50 вопросов минимум, чтобы понять что и как. Ибо в ином случае получится сферический конь в вакууме. Можете еще почитать мои ответы тут: https://qna.habr.com/user/eduardtibet/tag_answers?tag=%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%86%D0%B8%D1%8F постепенно с самого верхнег и дальше по цепочке. Вам будет сразу понятно, какие вопросы задавать.

+1 к Эдуарду, выбор и внедрение инструментов для разработки документации это задача не для джуна.

А вы будете первым техническим писателем в компании?

Судя по тому, что я увидел в разделе support - похоже на то. Там бессистемный набор статей в самом начале развития. Типичный футпринт кейса, когда документацию пишут потому, что "больше без нее никак".

И документация по API не выставлена наружу. Это очень странно для SaaS сервиса, претендующего на захват большой части рынка. Единственная причина, которую я вижу - быстро пилили софт и было не до документации. А сейчас резко понадобилась, т.к. дальнейшее масштабирование продаж без этого встанет колом.

нет, один уже есть, второго нанимают из-за объема работы

Я не совсем понимаю тогда причины таких вопросов в задании (!). Я понимаю логику, если бы это спросили на собесе просто посмотреть, как вы мыслите. Но в тестовом?  Это выше моего понимания. В любом случае, что бы вы ни написали, это можно трактовать как 100%, так и 100% неправильно с любыми градациями внутри.

абсолютно с Вами согласна.

это да, готовьтесь к, возможно, рандомному провалу по причине, как минимум, потому что
*лентач.жпг*

Это точно не для джуниора задача.

То есть, вы предлагаете отослать вопросы по тестовому заданию простому кадровику?
У меня есть подозрения, что такой запрос останется без ответа )

Обычно HR выступает в роли посредника. Если у конторы все в порядке с внутренними коммуникациями, то HR просто редиректит это письмо тому, кто составлял задание со словами: "А вот тут кандидат А спрашивает про B, С, D, E. Ответите?" И тот, кто составлял либо свяжется сам (что маловероятно, хотя встречается в стартапах), либо (что наиболее вероятно), перешлет через HR ответы на вопросы, которые задал кандидат. Если контора устроена так, что письма на HR уходят в никуда - возникают определенные вопросы и сомнения относительно того, стоит ли туда идти в принципе. Т.к. отсутствие респонза на обратную связь - это очень тревожный звоночек в вопросах уважения к потенциальным сотрудникам. И это, кстати, подтверждается личным опытом. Те компании, где "не ответили", "забыли про интервью", "ответили на от..ись" - обычно имеют очень плохие фидбеки на всяких глассдорах, кунуну и т.п. Т.е., как говорит одна английская пословица - where there is a smoke there is a fire (наш эквивалент -  нет дыма без огня).

Я более чем скептичен. Простого респонса на резюме от кадровиков не дождёшься, а тут уже Коммуникация высшего порядка.
Что же касается bad reputation, то это явно не тот фактор, который явно  интересен хоть кому-нибудь.

Прямо зависит от компании. Если у компании поток (т.н. галеры), то все естественно пофигу. Если же речь идет о РФ-филиалах компаний, то как правило (подчеркиваю, как правило, бывают исключения, конечно), все гораздо лучше.