When making a javascript library, where is a good place to document the API?
<p>I am making a library to generate some custom content. It is pretty verbose, about 1100 lines of code. Although the code is very readable and follows strict naming conventions, I am unsure where to document the API available when including the script file. When including the script in a page, intellisense does not pick up the "public" methods, nor does it for jQuery. jQuery has an awesome website for their API ( <a href="http://api.jquery.com/" rel="nofollow">http://api.jquery.com/</a> ), but I do not feel inclined to make something as awesome as that.</p>

<p>Where should I document this custom API?</p>

<p><em>If</em> in comments, what structure of comments would you suggest?</p>

<p><em>Edit</em></p>

<p>My point for intellisense was that even good naming conventions are going to require documented API. So I am definitely interested in a generic approach.</p>
