Linguistische Fragen zu Javadoc bzw. Englisch

[-frank]

ich wollte euch fragen, ob ihr in (englischen) Javadoc-Kommentaren Gegenwart oder Zukunft verwendet. Ich spreche zum Beispiel von ner Methode, dir irgendetwas mit einem Array macht und null-Werte überspringt. Schreibt ihr dann sowas wie "null values/objects are skipped/ignored" oder ".. will be skipped"?
und ist die passive variante besser oder doch eher aktiv, also zb "this method skips null values"?

verstehen wird mans wohl in allen fällen und darum gehts ja auch (muss ja meist nicht perfekt ausformuliert sein), aber da ich etliches zu kommentieren habe, würde ich gerne wissen, welches da die (von euch) preferierte variante ist. danke!

 

[mikachu]

na das was in deinem beispiel die methode macht, wenn diese dran ist mit auführen, also dann isses ja aktiv

immer nur aktiv. wenn jez eine variable in einer anderen methode, die vll gar nicht aufgerufen wird, verändert wird, dann schreib ich immer futur. ebenso andersrum.

 

[jPat]

Mir gefällt es so besser:
.. will be skipped

 

[NTB]

So wie im Deutschen benutze ich hier auch im Englischen Present.

 

[-frank]

danke mal für die antworten.
vielleicht wäre ne umfrage besser gewesen