Meu animal de estimação da programação odeia # 96

Já vi muitos exemplos de algo assim;

// Send email report upon receipt (1 = yes, 0 = no)  
$send_email_report
= 0;

Quando algo assim faz mais sentido lógico;

// Send email report upon receipt  
$send_email_report
= false;

Se precisar explicar os significados dos valores no documento, você está fazendo isso errado.

Além disso, usar verdadeiro / falso em 1/0 torna o código muito mais legível, tanto para desenvolvedores quanto para não desenvolvedores.