Come dovrei commentare un metodo?
Quali sono le migliori pratiche sul codice di commento?
Esempio:
/* Checks if a color is allowed in a given point
* of the bitmapdata of the current floor
* @param value - color to be checked
* @return boolean - if color is allowed returns true, else, return false
*/
private function isAllowed(value:uint):Boolean {
//code...
}
È il modo migliore per commentare un metodo?
Ho sentito che c'è l'uso del tag @eeee. Cosa dovrebbe essere su questo tag? Mi chiedo se potrebbe essere qualcosa che ha una relazione con il metodo, giusto?
Grazie.