Merge pull request #3908 from ahardin-rh/3353-followup

Follow-up edits to PR#3353

Author: ahardin-rh

Diff for: dev_guide/create_from_url.adoc

@@ -11,17 +11,16 @@
 
 toc::[]
 
-[[overview]]
 == Overview
 
 Create From URL is a function that allows you to construct a URL from an image
 stream, image tag, or template.
 
-Create from URL only works with image streams or templates from
-namespaces that have been explicitly whitelisted.  The whitelist contains
-the 'openshift' namespace by default.  To add namespaces to the whitelist, see
-xref:../install_config/web_console_customization.adoc#configuring-the-create-
-from-url-namespace-whitelist[Configuring the Create From URL Namespace Whitelist].
+Create from URL only works with image streams or templates from namespaces that
+have been explicitly whitelisted. The whitelist contains the `openshift`
+namespace by default. To add namespaces to the whitelist, see
+xref:../install_config/web_console_customization.adoc#configuring-the-create-from-url-namespace-whitelist[Configuring
+the Create From URL Namespace Whitelist].
 
 [[create-for-url-using-an-image-stream-and-image-tag]]
 == Using an Image Stream and Image Tag
@@ -32,24 +31,25 @@ from-url-namespace-whitelist[Configuring the Create From URL Namespace Whitelist
 [options="header"]
 |===
 |Name|Description|Required|Schema|Default
-|imageStream|The value metadata.name as defined in the image stream to be used.|
+|`imageStream`|The value `metadata.name` as defined in the image stream to be used.|
 true|string|
-|imageTag|The value spec.tags.name as defined in the image stream to be used.|
+|`imageTag`|The value `spec.tags.name` as defined in the image stream to be used.|
 true|string|
-|namespace|The name of the namespace containing the image stream and image tag
-to use.|false|string|openshift
-|name|Identifies the resources created for this application.|false|string|
-|sourceURI|The git repository URL containing the application source code.|false|
+|`namespace`|The name of the namespace containing the image stream and image tag
+to use.|false|string|`openshift`
+|`name`|Identifies the resources created for this application.|false|string|
+|`sourceURI`|The Git repository URL containing the application source code.|false|
 string|
-|sourceRef|The branch, tag, or commit for the application source code specified
-in sourceURI.|false|string|
-|contextDir|The subdirectory for the application source code specified in
-sourceURI, used as the context directory for the build.|false|string|
+|`sourceRef`|The branch, tag, or commit for the application source code specified
+in `sourceURI`.|false|string|
+|`contextDir`|The subdirectory for the application source code specified in
+`sourceURI`, used as the context directory for the build.|false|string|
 |===
 
 [NOTE]
 ====
-link:https://en.wikipedia.org/wiki/Percent-encoding#Percent-encoding_reserved_characters[Reserved characters] in parameter values should be URL encoded.
+link:https://en.wikipedia.org/wiki/Percent-encoding#Percent-encoding_reserved_characters[Reserved
+characters] in parameter values should be URL encoded.
 ====
 
 [[example-usage-of-an-image-stream-and-image-tag]]
@@ -67,16 +67,17 @@ link:https://en.wikipedia.org/wiki/Percent-encoding#Percent-encoding_reserved_ch
 [options="header"]
 |===
 |Name|Description|Required|Schema|Default
-|template|The value of metadata.name as defined in the template to be used.|
+|`template`|The value of `metadata.name` as defined in the template to be used.|
 true|string|
-|templateParamsMap|A JSON parameters map containing the template parameter name
+|`templateParamsMap`|A JSON parameters map containing the template parameter name
 and corresponding value you wish to override.|false|JSON|
-|namespace|The name of the namespace containing the template to use.|false|string|openshift
+|`namespace`|The name of the namespace containing the template to use.|false|string|`openshift`
 |===
 
 [NOTE]
 ====
-link:https://en.wikipedia.org/wiki/Percent-encoding#Percent-encoding_reserved_characters[Reserved characters] in parameter values should be URL encoded.
+link:https://en.wikipedia.org/wiki/Percent-encoding#Percent-encoding_reserved_characters[Reserved
+characters] in parameter values should be URL encoded.
 ====
 
 [[example-usage-of-a-template]]

Diff for: install_config/web_console_customization.adoc

@@ -520,48 +520,44 @@ endif::[]
 
 xref:../dev_guide/create_from_url.adoc#dev-guide-create-from-url[Create from URL]
 only works with image streams or templates from namespaces that have been
-explicitly specified in OPENSHIFT_CONSTANTS.CREATE_FROM_URL_WHITELIST.  To add
+explicitly specified in `OPENSHIFT_CONSTANTS.CREATE_FROM_URL_WHITELIST`.  To add
 namespaces to the whitelist, follow these steps:
 
 [NOTE]
 ====
-'openshift' is included in the whitelist by default.  It should not be removed.
+`openshift` is included in the whitelist by default. Do not remove it.
 ====
 
 . Create the following configuration scripts within a file (for example,
 *_create-from-url-whitelist.js_*):
 +
-====
 ----
 // Add a namespace containing the image streams and/or templates
 window.OPENSHIFT_CONSTANTS.CREATE_FROM_URL_WHITELIST.push(
   'shared-stuff'
 );
 ----
-====
 
-. Save the file and add it to the master configuration at
+. Save the file and add it to the master configuration file at
 *_/etc/origin/master/master-config.yml_*:
 +
-====
 ----
 assetConfig:
   ...
   extensionScripts:
     - /path/to/create-from-url-whitelist.js
 ----
-====
 
 . Restart the master host:
 +
-====
+----
 ifdef::openshift-origin[]
 # systemctl restart origin-master
 endif::[]
 ifdef::openshift-enterprise[]
 # systemctl restart atomic-openshift-master
 endif::[]
-====
+----
 
 endif::[]