The following text is a partial translation of the original English article, performed by ChatGPT (gpt-3.5-turbo) and this Jekyll plugin:
Ошибкой является то, что мы находим в программном продукте и “выглядит неправильно” (это моя личная определение). Ошибка может быть скрытой или видимой; она может быть “уже исправленной” или “по-прежнему присутствующей”; она может быть критической или косметической; она может быть срочной или иметь низкий приоритет. Важно то, что чем больше ошибок мы сможем найти и исправить до того, как их увидят наши клиенты, тем выше будет воспринимаемое качество программного обеспечения. Проще говоря, ошибки - это очень хорошо, если они найдены нами, а не нашими клиентами. Мы платим нашим программистам за каждую найденную ошибку. Вот шпаргалка для них, показывающая, где и как они могут найти эти ошибки, чтобы заработать больше денег.
Очевидно, если что-то сломано, это ошибка; здесь нет необходимости упоминать это. Однако, когда продукт более или менее стабилен, не слишком много вещей видимо сломаны. Но мы все равно платим за ошибки. На что вам следует обратить внимание? Читайте дальше. Этот список (в случайном порядке) вам поможет.
Отсутствие функциональности. Если класс (yegor256/cactoos#558) или весь модуль (yegor256/cactoos#399) не предоставляет функциональность, которую вы ожидаете, это ошибка.
Отсутствие тестов. Если класс не имеет модульного теста (yegor256/takes#43) или существующий тест не покрывает некоторые критические аспекты класса (yegor256/cactoos#375), это ошибка.
Отсутствие документации. Если, скажем, блок Javadoc для класса не объясняет вам ясно, как использовать класс, или весь модуль плохо задокументирован (yegor256/takes#790), это ошибка.
Неоптимальная реализация. Если кусок кода вам не нравится и вы думаете, что его можно переделать так, чтобы он выглядел лучше, это ошибка.
Несогласованность дизайна. Если дизайн вам кажется нелогичным (yegor256/cactoos#436) и вы знаете, как его можно улучшить, это ошибка.
Странное наименование. Если имена классов, переменных или пакетов выглядят несогласованными и неочевидными для вас, и вы знаете, как их можно исправить (yegor256/cactoos#274), это ошибка.
Нестабильный тест. Если модульный тест иногда не проходит (yegor256/takes#506) или не работает в какой-то конкретной среде (yegor256/jpeek#151), это ошибка.
Также стоит упомянуть, что мелкие, косметические или плохо формулированные отчеты об ошибках скорее всего будут отклонены или не будут оплачены. Если вы хотите, чтобы мы платили за ваши отчеты об ошибках, убедитесь, что они звучат правильно, чтобы помочь нам двигаться вперед к лучшему состоянию проекта.
Translated by ChatGPT gpt-3.5-turbo/42 on 2023-12-17 at 15:22
