It is important to provide documentation for all packages, classes, traits, methods, and other members. Scaladoc generally follows the conventions of Javadoc, but provides many additional features that simplify writing documentation for Scala code. In general, you want to worry more about substance and writing style than about formatting. Scaladocs need to be useful to new users of the code as wel