You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@openwhisk.apache.org by pd...@apache.org on 2018/09/05 21:06:42 UTC

[incubator-openwhisk-website] 02/03: Revert "Fix documentation typos and adjust layout (#328)"

This is an automated email from the ASF dual-hosted git repository.

pdesai pushed a commit to branch revert-327-fixlist
in repository https://gitbox.apache.org/repos/asf/incubator-openwhisk-website.git

commit 8d9b968a1e7164782d924e25207206e567b05440
Author: Priti Desai <pd...@us.ibm.com>
AuthorDate: Wed Sep 5 14:06:38 2018 -0700

    Revert "Fix documentation typos and adjust layout (#328)"
    
    This reverts commit 01ae665ec571f04cb2a5f3ed575c5252ee467856.
---
 _layouts/documentation.html | 189 ++++++++++++++++++++++++--------------------
 _layouts/home.html          |   7 --
 _scss/_skin.scss            |  34 +++++---
 _scss/_variables.scss       |   5 +-
 package.json                |   3 -
 5 files changed, 126 insertions(+), 112 deletions(-)

diff --git a/_layouts/documentation.html b/_layouts/documentation.html
index 17d3d18..f208877 100644
--- a/_layouts/documentation.html
+++ b/_layouts/documentation.html
@@ -6,95 +6,115 @@ layout: default
 # license agreements; and to You under the Apache License, Version 2.0.
 -->
 
-<div id="whiskIndexedLayout">
+<div class="whiskIndexedLayout">
     <!-- Documentation Index -->
-    <div id="whiskIndex">
+    <div class="whiskIndex">
         <ul>
             <li><a href="#documentation">Documentation</a></li>
             <li><a href="#project-structure">Project Structure</a></li>
 
             <!-- Operators -->
-            <li class="collapsible-toggle"><a href="#operators">Operators</a></li>
-            <ul class="collapse-content">
-                <li><a href="#openwhisk_architecture">OpenWhisk Architecture</a></li>
-                <li class="collapsible-toggle"><a href="#openwhisk_deployment">OpenWhisk Deployment</a></li>
+            <li class="collapsible-toggle">
+                <a href="#operators">Operators</a>
                 <ul class="collapse-content">
-                    <li><a href="#deploy_docker_compose">Docker Compose</a></li>
-                    <li><a href="#deploy_kubernetes">Kubernetes</a></li>
-                    <li><a href="#deploy_mesos">Mesos</a></li>
-                    <li><a href="#deploy_openshift">OpenShift</a></li>
-                    <li><a href="#deploy_ansible">Ansible</a></li>
-                    <li><a href="#deploy_vagrant">Vagrant</a></li>
+                    <li class="collapsible-toggle"><a href="#openwhisk_deployment">OpenWhisk Deployment</a>
+                        <ul class="collapse-content">
+                            <li><a href="#deploy_docker_compose">Docker Compose</a></li>
+                            <li><a href="#deploy_kubernetes">Kubernetes</a></li>
+                            <li><a href="#deploy_mesos">Mesos</a></li>
+                            <li><a href="#deploy_openshift">OpenShift</a></li>
+                            <li><a href="#deploy_ansible">Ansible</a></li>
+                            <li><a href="#deploy_vagrant">Vagrant</a></li>
+                        </ul>
+                    </li>
+                    <li><a href="#deployment_admin">Administrative Operations</a></li>
+                    <li><a href="#operators_resources">Operators Resources</a></li>
                 </ul>
-                <li><a href="#deployment_admin">Administrative Operations</a></li>
-                <li><a href="#operators_resources">Operators Resources</a></li>
-            </ul>
+            </li>
 
             <!-- Developers -->
-            <li class="collapsible-toggle"><a href="#developers">Developers</a></li>
-            <ul class="collapse-content">
-                <li><a href="#pre-requisites">Pre-requisites</a></li>
-                <li class="collapsible-toggle"><a href="#using-openwhisk">Using OpenWhisk</a></li>
+            <li class="collapsible-toggle">
+                <a href="#developers">Developers</a>
                 <ul class="collapse-content">
-                    <li><a href="#wsk-cli-install">Installing wsk CLI</a></li>
-                    <li><a href="#wsk-cli">OpenWhisk CLI (wsk)</a></li>
-                    <li><a href="#wskdeploy">Whisk Deploy (wskdeploy)</a></li>
-                    <li><a href="#rest-api">OpenWhisk REST API</a></li>
-                    <li><a href="#openwhisk-clients">OpenWhisk Clients (language)</a></li>
-                </ul>
-                <li class="collapsible-toggle"><a href="#actions">Actions</a></li>
-                <ul class="collapse-content">
-                    <li class="collapsible-toggle"><a href="#nodejs">NodeJS</a></li>
-                    <ul class="collapse-content">
-                        <li><a href="#nodejs-actions">Creating and Invoking Sample Action</a></li>
-                        <li><a href="#nodejs-runtime">NodeJS Runtime</a></li>
-                        <li><a href="#nodejs-additional-resources">Additional Resources</a></li>
-                    </ul>
-                    <li class="collapsible-toggle"><a href="#python">Python</a></li>
-                    <ul class="collapse-content">
-                        <li><a href="#python-actions">Creating and Invoking Sample Action</a></li>
-                        <li><a href="#python-runtime">Python Runtime</a></li>
-                        <li><a href="#python-additional-resources">Additional Resources</a></li>
-                    </ul>
-                    <!--li><a href="#docker">Docker</a></li>
-                    <ul>
-                        <li>Zip Action</li>
-                        <li>SDK (Writing Your Own Runtime)</li>
-                        <li>Other Resources</li>
-                    </ul-->
-                    <li class="collapsible-toggle"><a href="#go">Go</a></li>
-                    <ul class="collapse-content">
-                        <li><a href="#go-actions">Creating and Invoking Action</a></li>
-                        <li><a href="#go-runtime">Go Runtime</a></li>
-                        <li><a href="#go-additional-resources">Additional Resources</a></li>
-                    </ul>
-                    <li class="collapsible-toggle"><a href="#java">Java</a></li>
-                    <ul class="collapse-content">
-                        <li><a href="#java-actions">Creating and Invoking Action</a></li>
-                        <li><a href="#java-runtime">Java Runtime</a></li>
-                        <li><a href="#java-additional-resources">Additional Resources</a></li>
-                    </ul>
-                    <li class="collapsible-toggle"><a href="#php">PHP</a></li>
-                    <ul class="collapse-content">
-                        <li><a href="#php-actions">Creating and Invoking Action</a></li>
-                        <li><a href="#php-runtime">PHP Runtime</a></li>
-                        <li><a href="#php-additional-resources">Additional Resources</a></li>
-                    </ul>
-                    <!--li class="collapsible-toggle"><a href="#swift">Swift</a></li>
-                    <ul class="collapse-content">
-                        <li><a href="#swift-actions">Creating and Invoking Action</a></li>
-                        <li><a href="#swift-runtime">Swift Runtime</a></li>
-                        <li><a href="#swift-additional-resources">Additional Resources</a></li>
-                    </ul-->
+                    <li><a href="#pre-requisites">Pre-requisites</a></li>
+                    <li class="collapsible-toggle">
+                        <a href="#using-openwhisk">Using OpenWhisk</a>
+                        <ul class="collapse-content">
+                            <li><a href="#wsk-cli-install">Installing wsk CLI</a></li>
+                            <li><a href="#wsk-cli">Configuring wsk CLI</a></li>
+                            <li><a href="#wskdeploy">Deployment Tool - wskdeploy</a></li>
+                            <li><a href="#rest-api">OpenWhisk REST API</a></li>
+                            <li><a href="#openwhisk-clients">OpenWhisk Clients</a></li>
+                        </ul>
+                    </li>
+                    <li class="collapsible-toggle">
+                        <a href="#actions">Actions</a>
+                        <ul class="collapse-content">
+                            <li class="collapsible-toggle">
+                                <a href="#nodejs">NodeJS</a>
+                                <ul class="collapse-content">
+                                    <li><a href="#nodejs-actions">Creating and Invoking Sample Action</a></li>
+                                    <li><a href="#nodejs-runtime">NodeJS Runtime</a></li>
+                                    <li><a href="#nodejs-additional-resources">Additional Resources</a></li>
+                                </ul>
+                            </li>
+                            <li class="collapsible-toggle">
+                                <a href="#python">Python</a>
+                                <ul class="collapse-content">
+                                    <li><a href="#python-actions">Creating and Invoking Sample Action</a></li>
+                                    <li><a href="#python-runtime">Python Runtime</a></li>
+                                    <li><a href="#python-additional-resources">Additional Resources</a></li>
+                                </ul>
+                            </li>
+                            <!--li><a href="#docker">Docker</a>
+                            <ul>
+                                <li>Zip Action</li>
+                                <li>SDK (Writing Your Own Runtime)</li>
+                                <li>Other Resources</li>
+                            </ul></li>-->
+                            <li class="collapsible-toggle">
+                                <a href="#go">Go</a>
+                                <ul class="collapse-content">
+                                    <li><a href="#go-actions">Creating and Invoking Action</a></li>
+                                    <li><a href="#go-runtime">Go Runtime</a></li>
+                                    <li><a href="#go-additional-resources">Additional Resources</a></li>
+                                </ul>
+                            </li>
+                            <li class="collapsible-toggle">
+                                <a href="#java">Java</a>
+                                <ul class="collapse-content">
+                                    <li><a href="#java-actions">Creating and Invoking Action</a></li>
+                                    <li><a href="#java-runtime">Java Runtime</a></li>
+                                    <li><a href="#java-additional-resources">Additional Resources</a></li>
+                                </ul>
+                            </li>
+                            <li class="collapsible-toggle">
+                                <a href="#php">PHP</a>
+                                <ul class="collapse-content">
+                                    <li><a href="#php-actions">Creating and Invoking Action</a></li>
+                                    <li><a href="#php-runtime">PHP Runtime</a></li>
+                                    <li><a href="#php-additional-resources">Additional Resources</a></li>
+                                </ul>
+                            </li>
+                            <!--li class="collapsible-toggle">
+                              <a href="#swift">Swift</a>
+                                <ul class="collapse-content">
+                                    <li><a href="#swift-actions">Creating and Invoking Action</a></li>
+                                    <li><a href="#swift-runtime">Swift Runtime</a></li>
+                                    <li><a href="#swift-additional-resources">Additional Resources</a></li>
+                                </ul>
+                            </li>-->
+                        </ul>
+                    </li>
+                    <li><a href="#managing_actions_with_openwhisk_packages">Managing Actions with OpenWhisk Packages</a></li>
+                    <li><a href="#connecting_actions_to_event_sources">Connecting Actions to Event Sources</a></li>
+                    <li><a href="#using_openwhisk_enabled_services">Using OpenWhisk Enabled Services</a></li>
+                    <!--li><a href="#exposing_apis_from_actions">Exposing APIs from Actions</a></li-->
+                    <li><a href="#sample_openwhisk_applications">Sample OpenWhisk Applications</a></li>
+                    <li><a href="#tutorial_and_workshop">Tutorial And Workshop</a></li>
+                    <li><a href="#development_tools">Development Tools</a></li>
                 </ul>
-                <li><a href="#managing_actions_with_openwhisk_packages">Managing Actions with OpenWhisk Packages</a></li>
-                <li><a href="#connecting_actions_to_event_sources">Connecting Actions to Event Sources</a></li>
-                <li><a href="#using_openwhisk_enabled_services">Using OpenWhisk Enabled Services</a></li>
-                <!--li><a href="#exposing_apis_from_actions">Exposing APIs from Actions</a></li-->
-                <li><a href="#sample_openwhisk_applications">Sample OpenWhisk Applications</a></li>
-                <li><a href="#tutorial_and_workshop">Tutorial And Workshop</a></li>
-                <li><a href="#development_tools">Development Tools</a></li>
-            </ul>
+            </li>
 
             <!-- Contributors -->
             <li><a href="#contributors">Contributors</a></li>
@@ -162,7 +182,7 @@ layout: default
                 </div>
                 <div class="project-structure-repo theme-deeper-sky-blue">
                     <h4>Runtimes</h4>
-                    <p>OpenWhisk supports several languages via Docker runtime containers.</p>
+                    <p>OpenWhisk supports several languages and runtimes.</p>
                     <p class="repo-title border-deeper-sky-blue">
                         <a
                             href="https://github.com/apache/incubator-openwhisk-runtime-nodejs"
@@ -305,7 +325,7 @@ layout: default
                 </div>
                 <div class="project-structure-repo theme-darksalmon">
                     <h4>Packages</h4>
-                    <p>Several common service integrations are made available as packages. By default they are registered in the catalog under /whisk.system/ and include:</p>
+                    <p>Several packages are registered with OpenWhisk under /whisk.system/. These are the list of packages:</p>
                     <p class="repo-title border-darksalmon">
                         <a
                             href="https://github.com/apache/incubator-openwhisk-package-alarms"
@@ -494,8 +514,8 @@ layout: default
     <!-- Deployment section under Operator -->
     <main class="doc">
         <div class="content">
-            <a class="indexable" id="openwhisk_architecture"></a>
-            <h3>OpenWhisk Architecture</h3>
+            <a class="indexable" id="openwhisk_deployment"></a>
+            <h3>OpenWhisk Deployment</h3>
             <img style="padding-top:20px;" width="400px" src="https://raw.githubusercontent.com/apache/incubator-openwhisk/master/docs/images/OpenWhisk_flow_of_processing.png" alt="OpenWhisk Architecture"/>
             <p>
                 The above diagram depicts the high-level architecture of OpenWhisk. From Nginx to Kafka to Docker,
@@ -503,8 +523,6 @@ layout: default
                 You can read about the list of OpenWhisk components and its internal flow of processing
                 <a href="https://github.com/apache/incubator-openwhisk/blob/master/docs/about.md#the-internal-flow-of-processing">here</a>.
             </p>
-            <a class="indexable" id="openwhisk_deployment"></a>
-            <h3>OpenWhisk Deployment</h3>
             <p>
                 OpenWhisk supports different installation methods for core OpenWhisk components.
                 You can choose one of the following deployment methods based on your platform:
@@ -685,11 +703,10 @@ $ brew install wsk
 
 
             <a class="indexable" id="wsk-cli"></a>
-            <h5>OpenWhisk CLI</h5>
+            <h5>Configure the wsk CLI</h5>
             <p>
                 OpenWhisk offers wsk Command Line Interface (CLI) to easily create, run, and manage OpenWhisk entities.
             </p>
-            <h6>Configuring the CLI</h6>
             <ul>
                 <li>
                     <strong>CLI Help:</strong>
@@ -1785,4 +1802,4 @@ abcd.... locationUpdate
         </div>
     </main>
 </section>
-</div>
\ No newline at end of file
+</div>
diff --git a/_layouts/home.html b/_layouts/home.html
index 579b1fb..127000e 100644
--- a/_layouts/home.html
+++ b/_layouts/home.html
@@ -16,7 +16,6 @@ layout: default
 
 <section id="whiskNodes">
     <main>
-        <a class="indexable" id="what-is-openwhisk"></a>
         <div class="content">
             <h4>What is Apache OpenWhisk?</h4>
             <p>
@@ -33,7 +32,6 @@ layout: default
     </main>
 
     <main>
-        <a class="indexable" id="openwhisk-deployments"></a>
         <div class="image-wrapper">
             <img src="{{ site.github.url }}/images/illustrations/OW-Deployments.png" alt="Apache OpenWhisk can deploy on your favorite Cloud container framework."/>
         </div>
@@ -46,7 +44,6 @@ layout: default
     </main>
 
     <main>
-        <a class="indexable" id="openwhisk-languages"></a>
         <div class="content">
             <h4>Write functions in any language</h4>
             <!-- Possible text addition: "bundle larger or complex dependencies, and tailor the runtime environment to suite your needs."" -->
@@ -76,7 +73,6 @@ layout: default
     </main>
 
     <main>
-        <a class="indexable" id="openwhisk-packages"></a>
         <div class="image-wrapper">
             <img src="{{ site.github.url }}/images/illustrations/OW-Integrations.png" alt="OpenWhisk's out-of-box packages easily integrate with our own services"/>
         </div>
@@ -114,7 +110,6 @@ layout: default
     </main>
 
     <main>
-        <a class="indexable" id="openwhisk-compositions"></a>
         <div class="content">
             <h4>Combine your functions into rich compositions</h4>
             <p>
@@ -134,7 +129,6 @@ layout: default
     </main>
 
     <main>
-        <a class="indexable" id="openwhisk-benefits"></a>
         <div class="image-wrapper">
             <img src="{{ site.github.url }}/images/illustrations/OW-Utilization-Scaling.png" alt="Apache OpenWhisk automatically scales and maximizes and server utilization as events trigger action functions.">
         </div>
@@ -149,7 +143,6 @@ layout: default
     </main>
 
     <main>
-        <a class="indexable" id="openwhisk-community"></a>
         <div class="content">
             <h4>Join a vibrant open source community</h4>
             <p>
diff --git a/_scss/_skin.scss b/_scss/_skin.scss
index 9925382..21b22ad 100644
--- a/_scss/_skin.scss
+++ b/_scss/_skin.scss
@@ -8,9 +8,14 @@ body {
   font-family: $font-family-default;
 }
 
-h1, h2, h3, h4, h5, h6 {
-    font-weight: $font-weight-bold;
-    margin: 0;
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+  font-weight: $font-weight-bold;
+  margin: 0;
 }
 
 h1 {
@@ -39,19 +44,24 @@ h5 {
 }
 
 h6 {
-    font-size: $h6-font-size;
-    font-style: italic;
-    line-height: $h6-line-height;
+  font-size: $h6-font-size;
+  line-height: $h6-line-height;
 }
 
-p, ul, ol, li {
-    font-size: $p-font-size;
-    font-weight: $p-font-weight;
-    line-height: $p-line-height;
-    color: $color-blue-dark-text;
+p,
+ul,
+ol,
+li {
+  font-size: $p-font-size;
+  font-weight: $p-font-weight;
+  line-height: $p-line-height;
+  color: $color-blue-dark-text;
 }
 
-a, a:visited, a:hover, a:active {
+a,
+a:visited,
+a:hover,
+a:active {
   color: $color-anchors;
 }
 
diff --git a/_scss/_variables.scss b/_scss/_variables.scss
index 597740b..a0ff1aa 100644
--- a/_scss/_variables.scss
+++ b/_scss/_variables.scss
@@ -157,10 +157,7 @@ $h4-font-size: 20px;
 $h4-line-height: 28px;
 
 $h5-font-size: 16px;
-$h5-line-height: 24px;
-
-$h6-font-size: 14px;
-$h6-line-height: 22px;
+$h5-line-height: 28px;
 
 $h6-font-size: $font-size-default;
 $h6-line-height: 24px;
diff --git a/package.json b/package.json
index 7260030..3deef39 100644
--- a/package.json
+++ b/package.json
@@ -28,8 +28,5 @@
     "rollup-plugin-babel": "^2.6.1",
     "rollup-plugin-uglify": "^1.0.1",
     "rollup-watch": "^2.5.0"
-  },
-  "dependencies": {
-    "latest-version": "^4.0.0"
   }
 }