I prefer proper /** ... */ Javadocs - for one thing, an IDE can show it to me without taking me to the source code for a class (method, field).