diff --git a/docs/getting-started/first-service.md b/docs/getting-started/first-service.md
index 40afb4ee6..d41c5422a 100644
--- a/docs/getting-started/first-service.md
+++ b/docs/getting-started/first-service.md
@@ -18,6 +18,9 @@ For those of you familiar with other **source-to-url** tools, this may seem fami
     --revision-name=world
     ```
 
+    ??? question "Why did I pass in `revision-name`?"
+        Note the name "world" which you passed in as "revision-name," naming your `Revisions` will help you to more easily identify them, but don't worry, you'll learn more about `Revisions` later.
+
 === "YAML"
 
     ``` bash
@@ -28,7 +31,7 @@ For those of you familiar with other **source-to-url** tools, this may seem fami
     spec:
       template:
         metadata:
-# This is the name of our new "Revision," see "?" box below for more details
+          # This is the name of our new "Revision," it must follow the convention {service-name}-{revision-name}
           name: hello-world
         spec:
           containers:
@@ -43,16 +46,17 @@ For those of you familiar with other **source-to-url** tools, this may seem fami
     ``` bash
     kubectl apply -f hello.yaml
     ```
+    ??? question "Why did I pass in the second name, `hello-world`?"
+        Note the name "hello-world" which you passed in under "metadata" in your YAML file. Naming your `Revisions` will help you to more easily identify them, but don't worry if this if a bit confusing now, you'll learn more about `Revisions` later.
 
-After Knative has successfully created your service, you should see the following:
+
+
+==**Expected output:**==
 ```{ .bash .no-copy }
 Service hello created to latest revision 'hello-world' is available at URL:
 http://hello.default.127.0.0.1.nip.io
 ```
 
-??? question "Why did I pass in `revision-name`?"
-    Note that the name "world" which you passed in as "revision-name" (or under "metadata" in your YAML file) is being used to create the `Revision`'s name (`latest revision "hello-world"...`). This will help you to more easily identify this particular `Revision`, but don't worry, we'll talk more about `Revisions` later.
-
 ## Run your Knative Service
 ```
 curl http://hello.default.127.0.0.1.nip.io