[SpaghettiCthulu]

I agree. We need a standardized format with support for both structured (classes, methods, etc.) and unstructured (language overview) documentation..