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:41 UTC
[incubator-openwhisk-website] 01/03: Revert "Revert "Fix
documentation typos and adjust layout (#328)" (#329)"
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 d538d858f8aed3e54dd7c39fd7a2cea0e04d2b60
Author: Priti Desai <pd...@us.ibm.com>
AuthorDate: Wed Sep 5 14:06:38 2018 -0700
Revert "Revert "Fix documentation typos and adjust layout (#328)" (#329)"
This reverts commit 38d350b3d0cfe2cc5658b5b3dc0f42b9983c585f.
---
_layouts/documentation.html | 189 ++++++++++++++++++++------------------------
_layouts/home.html | 7 ++
_scss/_skin.scss | 34 +++-----
_scss/_variables.scss | 5 +-
package.json | 3 +
5 files changed, 112 insertions(+), 126 deletions(-)
diff --git a/_layouts/documentation.html b/_layouts/documentation.html
index f208877..17d3d18 100644
--- a/_layouts/documentation.html
+++ b/_layouts/documentation.html
@@ -6,115 +6,95 @@ layout: default
# license agreements; and to You under the Apache License, Version 2.0.
-->
-<div class="whiskIndexedLayout">
+<div id="whiskIndexedLayout">
<!-- Documentation Index -->
- <div class="whiskIndex">
+ <div id="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 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>
<ul class="collapse-content">
- <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>
+ <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>
<!-- Developers -->
- <li class="collapsible-toggle">
- <a href="#developers">Developers</a>
+ <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>
<ul class="collapse-content">
- <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>
+ <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>
+ <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-->
+ </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>
<!-- Contributors -->
<li><a href="#contributors">Contributors</a></li>
@@ -182,7 +162,7 @@ layout: default
</div>
<div class="project-structure-repo theme-deeper-sky-blue">
<h4>Runtimes</h4>
- <p>OpenWhisk supports several languages and runtimes.</p>
+ <p>OpenWhisk supports several languages via Docker runtime containers.</p>
<p class="repo-title border-deeper-sky-blue">
<a
href="https://github.com/apache/incubator-openwhisk-runtime-nodejs"
@@ -325,7 +305,7 @@ layout: default
</div>
<div class="project-structure-repo theme-darksalmon">
<h4>Packages</h4>
- <p>Several packages are registered with OpenWhisk under /whisk.system/. These are the list of packages:</p>
+ <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 class="repo-title border-darksalmon">
<a
href="https://github.com/apache/incubator-openwhisk-package-alarms"
@@ -514,8 +494,8 @@ layout: default
<!-- Deployment section under Operator -->
<main class="doc">
<div class="content">
- <a class="indexable" id="openwhisk_deployment"></a>
- <h3>OpenWhisk Deployment</h3>
+ <a class="indexable" id="openwhisk_architecture"></a>
+ <h3>OpenWhisk Architecture</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,
@@ -523,6 +503,8 @@ 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:
@@ -703,10 +685,11 @@ $ brew install wsk
<a class="indexable" id="wsk-cli"></a>
- <h5>Configure the wsk CLI</h5>
+ <h5>OpenWhisk 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>
@@ -1802,4 +1785,4 @@ abcd.... locationUpdate
</div>
</main>
</section>
-</div>
+</div>
\ No newline at end of file
diff --git a/_layouts/home.html b/_layouts/home.html
index 127000e..579b1fb 100644
--- a/_layouts/home.html
+++ b/_layouts/home.html
@@ -16,6 +16,7 @@ layout: default
<section id="whiskNodes">
<main>
+ <a class="indexable" id="what-is-openwhisk"></a>
<div class="content">
<h4>What is Apache OpenWhisk?</h4>
<p>
@@ -32,6 +33,7 @@ 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>
@@ -44,6 +46,7 @@ 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."" -->
@@ -73,6 +76,7 @@ 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>
@@ -110,6 +114,7 @@ layout: default
</main>
<main>
+ <a class="indexable" id="openwhisk-compositions"></a>
<div class="content">
<h4>Combine your functions into rich compositions</h4>
<p>
@@ -129,6 +134,7 @@ 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>
@@ -143,6 +149,7 @@ 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 21b22ad..9925382 100644
--- a/_scss/_skin.scss
+++ b/_scss/_skin.scss
@@ -8,14 +8,9 @@ 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 {
@@ -44,24 +39,19 @@ h5 {
}
h6 {
- font-size: $h6-font-size;
- line-height: $h6-line-height;
+ font-size: $h6-font-size;
+ font-style: italic;
+ 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 a0ff1aa..597740b 100644
--- a/_scss/_variables.scss
+++ b/_scss/_variables.scss
@@ -157,7 +157,10 @@ $h4-font-size: 20px;
$h4-line-height: 28px;
$h5-font-size: 16px;
-$h5-line-height: 28px;
+$h5-line-height: 24px;
+
+$h6-font-size: 14px;
+$h6-line-height: 22px;
$h6-font-size: $font-size-default;
$h6-line-height: 24px;
diff --git a/package.json b/package.json
index 3deef39..7260030 100644
--- a/package.json
+++ b/package.json
@@ -28,5 +28,8 @@
"rollup-plugin-babel": "^2.6.1",
"rollup-plugin-uglify": "^1.0.1",
"rollup-watch": "^2.5.0"
+ },
+ "dependencies": {
+ "latest-version": "^4.0.0"
}
}