From e3ac0f1a6bc1568c810988d3f99ede2535022de2 Mon Sep 17 00:00:00 2001
From: kKronstainBrown <kakronst@us.ibm.com>
Date: Wed, 31 May 2017 14:01:47 -0400
Subject: [PATCH 1/2] Revised IBM Bluemix Container Service description

---
 docs/setup/pick-right-solution.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/setup/pick-right-solution.md b/docs/setup/pick-right-solution.md
index 1313cdc3ab..c6e7104c1e 100644
--- a/docs/setup/pick-right-solution.md
+++ b/docs/setup/pick-right-solution.md
@@ -58,7 +58,7 @@ a Kubernetes cluster from scratch.
 
 * [OpenShift Online](https://www.openshift.com/features/) provides free hosted access for Kubernetes applications.
 
-* [IBM Bluemix Container Service](https://console.ng.bluemix.net/docs/containers/container_index.html) offers managed Kubernetes clusters.
+* [IBM Bluemix Container Service](https://console.ng.bluemix.net/docs/containers/container_index.html) offers managed Kubernetes clusters with isolation choice, operational tools, integrated security insight into images and containers, and integration with Watson, IoT, and data.
 
 * [Giant Swarm](https://giantswarm.io/product/) offers managed Kubernetes clusters in their own datacenter, on-premises, or on public clouds.
 

From ab310e21cd27725c5a4a7953f55cba8721292e5f Mon Sep 17 00:00:00 2001
From: Steve Perry <steveperry-53@users.noreply.github.com>
Date: Wed, 31 May 2017 15:53:04 -0700
Subject: [PATCH 2/2] Templates (#3949)

* Update page-templates.md

* Update page-templates.md

* Update page-templates.md

* Update page-templates.md

* Update page-templates.md

* Update page-templates.md

* Update page-templates.md

* Update page-templates.md
---
 docs/home/contribute/page-templates.md | 30 ++++++++++++++++++--------
 1 file changed, 21 insertions(+), 9 deletions(-)

diff --git a/docs/home/contribute/page-templates.md b/docs/home/contribute/page-templates.md
index 60a65c0a23..caf5b41d90 100644
--- a/docs/home/contribute/page-templates.md
+++ b/docs/home/contribute/page-templates.md
@@ -26,7 +26,7 @@ to conceptual topics that provide related background and knowledge.</p>
 
 <p>To write a new task page, create a Markdown file in a subdirectory of the
 /docs/tasks directory. In your Markdown file, provide values for these
-variables, and then include templates/task.md:</p>
+variables:</p>
 
 <ul>
     <li>overview - required</li>
@@ -36,6 +36,11 @@ variables, and then include templates/task.md:</p>
     <li>whatsnext - optional</li>
 </ul>
 
+Then include templates/task.md like this:
+
+{% raw %}<pre>...
+{% include templates/task.md %}</pre>{% endraw %}
+
 <p>In the <code>steps</code> section, use <code>##</code> to start with a level-two heading. For subheadings,
 use <code>###</code> and <code>####</code> as needed. Similarly, if you choose to have a <code>discussion</code> section,
 start the section with a level-two heading.</p>
@@ -74,8 +79,7 @@ Here's an interesting thing to know about the steps you just did.
 * See this [related task](...).
 {% endcapture %}
 
-{% include templates/task.md %}
-</pre>
+{% include templates/task.md %}</pre>
 {% endraw %}
 
 <p>Here's an example of a published topic that uses the task template:</p>
@@ -93,7 +97,7 @@ for deep explanations.
 
 <p>To write a new tutorial page, create a Markdown file in a subdirectory of the
 /docs/tutorials directory. In your Markdown file, provide values for these
-variables, and then include templates/tutorial.md:</p>
+variables:</p>
 
 <ul>
     <li>overview - required</li>
@@ -104,6 +108,11 @@ variables, and then include templates/tutorial.md:</p>
     <li>whatsnext - optional</li>
 </ul>
 
+Then include templates/tutorial.md like this:
+
+{% raw %}<pre>...
+{% include templates/tutorial.md %}</pre>{% endraw %}
+
 <p>In the <code>lessoncontent</code> section, use <code>##</code> to start with a level-two heading. For subheadings,
 use <code>###</code> and <code>####</code> as needed.
 
@@ -154,8 +163,7 @@ Here's something interesting about the code you ran in the preceding steps.
 * See this [related tutorial](...).
 {% endcapture %}
 
-{% include templates/tutorial.md %}
-</pre>
+{% include templates/tutorial.md %}</pre>
 {% endraw %}
 
 <p>Here's an example of a published topic that uses the tutorial template:</p>
@@ -172,7 +180,7 @@ tutorials.
 
 <p>To write a new concept page, create a Markdown file in a subdirectory of the
 /docs/concepts directory. In your Markdown file,  provide values for these
-variables, and then include templates/concept.md:</p>
+variables:</p>
 
 <ul>
     <li>overview - required</li>
@@ -180,6 +188,11 @@ variables, and then include templates/concept.md:</p>
     <li>whatsnext - optional</li>
 </ul>
 
+Then include templates/concept.md like this:
+
+{% raw %}<pre>...
+{% include templates/concept.md %}</pre>{% endraw %}
+
 <p>In the <code>body</code> section, use <code>##</code> to start with a level-two heading. For subheadings,
 use <code>###</code> and <code>####</code> as needed.
 
@@ -209,8 +222,7 @@ To use ...
 * See this [related task](...).
 {% endcapture %}
 
-{% include templates/concept.md %}
-</pre>
+{% include templates/concept.md %}</pre>
 {% endraw %}
 
 <p>Here's an example of a published topic that uses the concept template:</p>