Есть ли документация по проекту
Что проверяют
Как на вашем прошлом проекте было устроено знание о коде и насколько вы сами в этом участвовали. Интервьюер хочет понять, оставите ли вы после себя понятный след или будете держать всё в голове. Следом часто просят: «Что бы вы написали новичку на первый день?»
Как отвечать
Опирайтесь на свой проект, а не на учебную классификацию. В iOS обычно есть что назвать:
- README и онбординг: какая версия Xcode нужна, как ставятся зависимости (Swift Package Manager, CocoaPods), генерируется ли проект через Tuist или XcodeGen, какие есть схемы и конфигурации;
- подписание и релиз: как получить сертификаты и профили (например, через
fastlane match), как выложить билд в TestFlight, где настроен CI: Xcode Cloud, GitHub Actions, Bitrise; - документация в коде: комментарии
///к публичному API модулей и справка, собранная через DocC, особенно если у вас свои SPM-пакеты; - архитектурные решения: ADR или страницы в Confluence и Notion, почему выбрали, например, TCA или координаторы;
- контракты: OpenAPI от бэкенда, макеты в Figma, таблица событий аналитики.
Дальше расскажите о своём вкладе: что писали сами, как держали тексты актуальными (правка README входит в тот же пул-реквест, что и изменение сборки). Примеры и цифры берите из своего опыта, например сколько дней занимал онбординг до и после.
Если документации почти не было, скажите честно и покажите, что сделали вы: собрали инструкцию по сборке, описывали неочевидные места в пул-реквестах. Если опыта нет вовсе, расскажите, что написали бы в первую очередь.
Этот же вопрос полезно задать работодателю в конце: ответ многое скажет о проекте.
Где спотыкаются
Говорят «код самодокументируемый». Код не объяснит, почему выбрано решение и где взять профиль подписи.
Перечисляют виды документации из учебника без единого примера из своей работы.
Жалуются на прошлую команду: «документации не было, всё было ужасно», и ничего не говорят о том, что сделали сами.