'git mv' rst resources to md

This is mainly intended to keep the git history as neat as possible.
No actual conversion yet, so now both the rst and the paradox docs
are broken, which will be fixed in the next commits.

akka-docs/src/main/paradox/scala/code/docs/remoting/RemoteDeploymentDocSpec.scala

@@ -0,0 +1,68 @@
+/**
+ * Copyright (C) 2009-2017 Lightbend Inc. <http://www.lightbend.com>
+ */
+package docs.remoting
+
+import akka.actor.{ ExtendedActorSystem, ActorSystem, Actor, ActorRef }
+import akka.testkit.{ AkkaSpec, ImplicitSender }
+//#import
+import akka.actor.{ Props, Deploy, Address, AddressFromURIString }
+import akka.remote.RemoteScope
+//#import
+
+object RemoteDeploymentDocSpec {
+
+  class SampleActor extends Actor {
+    def receive = { case _ => sender() ! self }
+  }
+
+}
+
+class RemoteDeploymentDocSpec extends AkkaSpec("""
+    akka.actor.provider = remote
+    akka.remote.netty.tcp {
+      port = 0
+    }
+""") with ImplicitSender {
+
+  import RemoteDeploymentDocSpec._
+
+  val other = ActorSystem("remote", system.settings.config)
+  val address = other.asInstanceOf[ExtendedActorSystem].provider.getExternalAddressFor(Address("akka.tcp", "s", "host", 1)).get
+
+  override def afterTermination() { shutdown(other) }
+
+  "demonstrate programmatic deployment" in {
+    //#deploy
+    val ref = system.actorOf(Props[SampleActor].
+      withDeploy(Deploy(scope = RemoteScope(address))))
+    //#deploy
+    ref.path.address should be(address)
+    ref ! "test"
+    expectMsgType[ActorRef].path.address should be(address)
+  }
+
+  def makeAddress(): Unit = {
+    //#make-address-artery
+    val one = AddressFromURIString("akka://sys@host:1234")
+    val two = Address("akka", "sys", "host", 1234) // this gives the same
+    //#make-address-artery
+  }
+
+  "demonstrate address extractor" in {
+    //#make-address
+    val one = AddressFromURIString("akka.tcp://sys@host:1234")
+    val two = Address("akka.tcp", "sys", "host", 1234) // this gives the same
+    //#make-address
+    one should be(two)
+  }
+
+  "demonstrate sampleActor" in {
+    //#sample-actor
+
+    val actor = system.actorOf(Props[SampleActor], "sampleActor")
+    actor ! "Pretty slick"
+    //#sample-actor
+  }
+
+}