OpenWhisk should have a well organized doc website.

Current status

OpenWhisk website has a menu item "Documentation" in menu "Docs", which is a hyperlink to docs folder in apache/incubator-openwhisk Github repo.

The docs folder in apache/incubator-openwhisk Github repo is a mix of all kinds of MD files, including:

  • entry point
  • System overview
  • creating and invoking actions
  • annotations used in CLI for OpenWhisk assets ( i.e. actions, triggers, rules, web actions, feeds, etc )
  • How to use API Gateway
  • How to use OpenWhisk enabled external services in the /whisk.system namespace.
  • how to set up, config and use CLI
  • Implementing feeds
  • how to install and use the mobile SDK
  • how to create and use packages with CLI
  • OpenWhisk system details
  • how to use REST APIs to manage OpenWhisk assets
  • OpenWhisk samples
  • what is triggers & rules and how to use triggers & rules.
  • common use cases of OpenWhisk
  • what is web action and how to create and use web actions
  • images: useful images in docs and whisk icons in different size
  • dev/ Web actions potential future enhancements

There are also documents in every folder and repository. We should integrate them all together and give a whole picture.


  1. Well organize the existing docs and publish in OpenWhisk website as an integrated documentation.
  2. Add scala docs as a developer reference, also a part of the integrated documentation.
Outlines and contents
  1. Quick start
  2. Deployment Guides
    1. Set up with Mac (incubator-openwhisk/tools/macos/
    2. Set up with Ubuntu (incubator-openwhisk/tools/ubuntu-setup/
    3. Setting up OpenWhisk with Docker-machine (incubator-openwhisk/tools/macos/docker-machine/
    4. Deploying OpenWhisk using Ansible (incubator-openwhisk/ansible/
    5. Deploying distributed OpenWhisk using Ansible (incubator-openwhisk/ansible/
  3. Programming Guides
    1. Event driven programming model
    2. Actions (
    3. Triggers (
    4. Rules (
    5. Feeds (
    6. Web actions (
    7. API Gateway (
    8. Packages (
  4. CLI Guides (
  5. System Catalog Guides (
  6. Packages Guides
    1. incubator-openwhisk-package-alarms
    2. incubator-openwhisk-package-cloudant
    3. incubator-openwhisk-package-jira
    4. incubator-openwhisk-package-kafka
    5. incubator-openwhisk-package-pushnotifications
    6. incubator-openwhisk-package-rss
  7. API Client Guides
    1. incubator-openwhisk-client-go
    2. incubator-openwhisk-client-js
    3. incubator-openwhisk-client-python
    4. incubator-openwhisk-client-swift
  8. Useful Tools
    1. Whisk Deploy
    2. Dev tools
  9. Restful APIs
  10. OpenWhisk Contributor Guides
    1. contributor guides
    2. Reference: Scala docs
Back end technologies


  • No labels