Yes, but it isn't enough information and TBH i do not think that at the language level you can have something that will provide a good enough UX (but then again i'm not in favor of Javadoc-style comments and i believe documentation should lie outside of the source code).