This directory is for keeping all the compiler related docs.

For serving this files, one should notice that files under docs/docs/reference and docs/docs/usage/scaladoc are designed to be compatible with docs.scala-lang jekyll page. Preprocessing the sources to be compatible with scaladoc static site is done via script at project/CopyDocs.scala