Hey! That's every JavaDocs I've ever encountered. See the Apple CoreAudio docs f... | Hacker News

Hacker Newsnew | past | comments | ask | show | jobs | submit

		JoeAltmaier on Oct 26, 2016 \| parent \| context \| favorite \| on: Why does software development take so long? Hey! That's every JavaDocs I've ever encountered. See the Apple CoreAudio docs for instance. Auto-generated and never revisited. Such doc systems are a crime - the Manager asks "Is the documentation complete?" and then Engineer says "Well the auto-docs were created but..." and the Manager says "Good, lets move on"

majewsky on Oct 26, 2016 [–]

On the other side of the spectrum, we have something like the Qt documentation: https://doc.qt.io/qt-5/qwidget.html

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact