diff --git a/docs/docs/usage/cbt-projects.md b/docs/docs/usage/cbt-projects.md
new file mode 100644
index 000000000000..1ae25efd5e81
--- /dev/null
+++ b/docs/docs/usage/cbt-projects.md
@@ -0,0 +1,19 @@
+---
+layout: default
+title: "cbt"
+---
+
+Using Dotty with cbt
+====================
+cbt comes with built-in dotty support. Follow the
+[cbt tutorial](https://github.com/cvogt/cbt/), then simply extend `Dotty` in the Build class.
+
+```scala
+// build/build.scala
+import cbt._
+class Build(val context: Context) extends Dotty{
+  ...
+}
+```
+
+Also see the [example project](https://github.com/cvogt/cbt/tree/master/examples/dotty-example).