title: Javadoc for project documentation
body: <p>I want to document a Java project I'm working on. In the past I've typically documented the design and software API in a wiki. However, after recently using <a href="http://mockito.org/" rel="noreferrer">Mockito</a> for mocking tests, I was impressed at the amount and quality of project-level documentation in the actual javadocs.</p>
  
  <p>My question is, do people typically use Javadocs for documenting the higher level view of the project (e.g. architecture, design decisions etc), or is this kind of information best documented in (say) a wiki?</p>