Nothing kills the urge to learn something quicker than incomplete docs. But it doesn't have to be this way. John Resig of JDoc fame, gets around this problem by concentrating on writing good documentation of the core API ~ http://blog.jquery.com/2006/09/02/taking-jquery-documentatio... (along with doing stacks of talks, demos) leaving the gaps for others to fill ~ http://www.html.it/articoli/johnresig/index.html