DOMANDA Tamagotchi in Java

[Mursey]

Dovrei commentarlo il programma secondo voi?

Secondo me sarebbe meglio.
E in inglese.

 

[Akrilix]

Secondo me sarebbe meglio.
E in inglese.

Eheheh, ma dovrei ritradurre tutto. Lo faccio in italiano intanto, poi se ho voglia traduco tutto in inglese.
Consigli sul come commentare al meglio?

 

[Mursey]

Consigli sul come commentare al meglio?

L'ideale sarebbe Javadoc
Non devi per forza usare il tool, basta rispettare lo standard:

/**
 * Returns an Image object that can then be painted on the screen. 
 * The url argument must specify an absolute {@link URL}. The name
 * argument is a specifier that is relative to the url argument. 
 * <p>
 * This method always returns immediately, whether or not the 
 * image exists. When this applet attempts to draw the image on
 * the screen, the data will be loaded. The graphics primitives 
 * that draw the image will incrementally paint on the screen. 
 *
 * @param  url  an absolute URL giving the base location of the image
 * @param  name the location of the image, relative to the url argument
 * @return      the image at the specified URL
 * @see         Image
 */
 public Image getImage(URL url, String name) {
        try {
            return getImage(new URL(url, name));
        } catch (MalformedURLException e) {
            return null;
        }
 }

 

[Akrilix]

L'ideale sarebbe Javadoc
Non devi per forza usare il tool, basta rispettare lo standard:

/**
* Returns an Image object that can then be painted on the screen.
* The url argument must specify an absolute {@link URL}. The name
* argument is a specifier that is relative to the url argument.
* <p>
* This method always returns immediately, whether or not the
* image exists. When this applet attempts to draw the image on
* the screen, the data will be loaded. The graphics primitives
* that draw the image will incrementally paint on the screen.
*
* @param  url  an absolute URL giving the base location of the image
* @param  name the location of the image, relative to the url argument
* @return      the image at the specified URL
* @see         Image
*/
public Image getImage(URL url, String name) {
        try {
            return getImage(new URL(url, name));
        } catch (MalformedURLException e) {
            return null;
        }
}

Javadoc non l'ho mai usato, se uso i commenti normali? Ho sempre fatto così anche a scuola e non mi ha mai detto niente il professore.

 

[Mursey]

Ho sempre fatto così anche a scuola e non mi ha mai detto niente il professore

Puoi commentare come vuoi, ma visto che hai chiesto ti ho detto una soluzione più professionale. ;)

 

[Akrilix]

Puoi commentare come vuoi, ma visto che hai chiesto ti ho detto una soluzione più professionale. ;)

Ok perfetto grazie mille