Где велась документация на последней работе

«Где велась документация на последней работе» — вопрос из категории Софт-скиллы, который задают на 23% собеседований Android Разработчик. Ниже — развёрнутый пример ответа, который можно адаптировать под свой опыт.

Ответ

В основном использовали Confluence для хранения технической документации, архитектурных решений и гайдов по процессам. API-документацию писали в Swagger/OpenAPI и прикрепляли к задачам в Jira.

Для внутренних библиотек поддерживали README.md в репозиториях Git с примерами использования, лицензией и changelog. Код документировали через KDoc (для Kotlin) с генерацией документации через Dokka.

Пример KDoc:

/**
 * Отправляет событие аналитики
 * @param eventName название события
 * @param params дополнительные параметры (nullable)
 * @throws AnalyticsException при ошибке сети
 */
fun trackEvent(eventName: String, params: Map<String, Any>?) {
    // implementation
}