indentar - phpstorm indentation
¿Cuál es la mejor manera de documentar el cambio intencional del cambio intencional? (1)
Aunque la pregunta se refiere explícitamente a phpDoc, aquí hay una solución específica de IDE para PHPStorm.
Para Javascript, comentar
//noinspection FallthroughInSwitchStatementJS
por encima de la declaración de cambio.
Para PHP, comenta
/** @noinspection PhpMissingBreakStatementInspection */
Por encima de la declaración del caso infractor.
Me he encontrado en una situación en la que un caso de cambio es la mejor opción. Con esto quiero decir:
switch($bar)
{
case 0:
// do something
case 1:
// do more
break;
//more cases
}
Actualmente mi IDE (phpStorm) está lanzando una advertencia sobre la caída.
¿Hay una forma aceptada en phpDoc para documentar tal caída intencionada?
nb Soy consciente de que algunos de ustedes indudablemente dirán que no deben hacer esto, pero me suscribo a esta definición de mal, y esta es sin duda la "la menos mala de las alternativas".