Javadoc FTW!?


Heute bin ich über ein gutes Beispiel gestolpert, wieso ich Javadoc mittlerweile ablehne und nur noch auf öffentlichen APIs haben will:

Super Javadoc!

Alles drin was man sich so wünscht:

  • Supergenerischer erster Satz
  • Fehlende Beschreibung
  • Hinweis auf mind. verbesserungswürdige Funktionalität (oder Bug?)
  • zur Abrundung noch ein Schreibfehler
  • vermutlich autogenerierte @version Annotation

Sowas kann man getrost weglassen.

Weitere Artikel

Der letzte PR

Fahrrad geklaut

Erstes Review des Sony XZ Premium

Unterschiedliche Sichtweisen

Vorbestellt: Sony Xperia XZ Premium

Giants Run 2017

Gelesen: SciFi Serie 'The Expanse'

Neue Tastatur: Pok3r Vortex RGB

New minecraft survival mod for 1.11.2

Änderungen beim Flug mit Quadkoptern