Обзор кода (Code Review и Code Style)
Контекст задачи
Набор правил и стандартов, определяющих, как должен быть написан код — включая форматирование, именование переменных и функций, стиль комментариев и многое другое — является основой для статического анализа программного кода. Code Review — это практика, при которой код проверяется другими разработчиками до слияния в основную ветку. Это не просто поиск опечаток: это передача знаний внутри команды, поддержание единого стиля и предотвращение багов до того, как они попадут в продакшен.
Формулировка
Проведите рецензирование программного кода (например, графического редактора из вашего проекта), оценив его соответствие стандартам кодирования. Составьте таблицу замечаний с категориями и предложений по исправлению.
Ожидаемый результат
- Заполненная таблица Code Review с замечаниями по каждой категории
- Предложения по исправлению для каждого замечания
- Итоговая оценка качества кода с обоснованием
Инструментарий
Методы и подходы:
- Анализ по категориям: именование, форматирование, логика, обработка ошибок, производительность
- Использование официальных стандартов кодирования (Code Conventions for the Java Programming Language)
- Оценка каждого замечания по тяжести: критическое, серьёзное, рекомендация
- Формирование резюме Code Review
Инструменты:
- Code Conventions for the Java Programming Language
- Чек-лист Code Review
- Вопрос: Какие правила кодирования нарушены чаще всего в вашем проекте, и как вы можете автоматизировать их проверку?
- Пример задачи: Руководствуясь Code Conventions for the Java Programming Language провести анализ и оценку программного кода.
📝 Критерии оценки
- Проведён анализ кода по всем категориям (именование, форматирование, логика, ошибки)
- Каждое замечание содержит: строку, описание проблемы, предложение по исправлению
- Замечания классифицированы по тяжести (критическое / серьёзное / рекомендация)
- Итоговая оценка качества кода обоснована
- Предложены конкретные шаги для устранения выявленных проблем
- Проверено соответствие официальному стандарту кодирования