phpdocumentor indentar example created code change php switch-statement phpstorm phpdoc

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".