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.