Wiem, że nie jest to najistotniejszy z problemów, ale właśnie zdałem sobie sprawę, że mogę umieścić blok komentarzy javadoc przed adnotacją lub po niej. Co chcielibyśmy przyjąć jako standard kodowania? /** * This is a javadoc comment before the annotation */ @Component public class MyClass {...
Jak mogę poinformować JSDoc o strukturze zwracanego obiektu. Znalazłem @return {{field1: type, field2: type, ...}} descriptionskładnię i wypróbowałem ją: /** * Returns a coordinate from a given mouse or touch event * @param {TouchEvent|MouseEvent|jQuery.Event} e * A valid mouse or touch event...
Mam funkcję, która akceptuje jeden parametr ciągu. Ten parametr może mieć tylko jedną z kilku zdefiniowanych możliwych wartości. Jaki jest najlepszy sposób na udokumentowanie tego samego? Czy shapeType należy zdefiniować jako enum, TypeDef czy coś innego? Shape.prototype.create = function...