Questions marquées «code-documentation»

codestyle; mettre javadoc avant ou après l'annotation?

Je sais que ce n'est pas le problème le plus vital, mais je viens de réaliser que je peux mettre le bloc de commentaires javadoc avant ou après l'annotation. Que voudrions-nous adopter comme norme de codage? /** * This is a javadoc comment before the annotation */ @Component public class MyClass {...

JSDoc: structure de l'objet de retour

Comment puis-je informer JSDoc de la structure d'un objet renvoyé. J'ai trouvé la @return {{field1: type, field2: type, ...}} descriptionsyntaxe et l' ai essayé: /** * Returns a coordinate from a given mouse or touch event * @param {TouchEvent|MouseEvent|jQuery.Event} e * A valid mouse or touch...