Scaladoc - Scaladoc for Library Authors - Scala Documentation

Scaladoc is a documentation system that lives in the comments of Scala source code and is related to the code structure within which it is written. It is based on other comment based documentation systems like Javadoc, but with some extensions such as:


This is a companion discussion topic for the original entry at http://docs.scala-lang.org//overviews/scaladoc/for-library-authors

Shouldn’t “markup” be “markdown”? “Markup” is a generic term that includes HTML, while “markdown” is the particular language.

Sadly, Scaladoc doesn’t use Markdown. Markdown didn’t even exist yet, back when Scaladoc was created.

You’re right, of course (although Markdown dates back to 2004). I was focusing on “wiki-like markup” vs HTML, but Scaladoc’s wiki-like markup is definitely not Markdown.

I got curious about the dates. Scaladoc 1 goes back to 2003; Scaladoc 2 dates to 2009. I don’t know why Markdown wasn’t chosen in 2009.