#22903 Fix code snippeds

* move scala and java sources out of paradox sources
* replace relative paths with $code$ and $akka$
* fix broken includes

akka-docs/src/main/scala/docs/CompileOnlySpec.scala

@@ -0,0 +1,13 @@
+/*
+ * Copyright (C) 2009-2017 Lightbend Inc. <http://www.lightbend.com>
+ */
+
+package docs
+
+trait CompileOnlySpec {
+  /**
+   * Given a block of code... does NOT execute it.
+   * Useful when writing code samples in tests, which should only be compiled.
+   */
+  def compileOnlySpec(body: => Unit) = ()
+}