alerts example

Author: lpabon

docs/README.md

@@ -1,6 +1,7 @@
-# Preface
-Preface here.
+# OpenStorage Library API
 
-# Introduction
-Introduction to the book here.
+## Introduction
+Welcome to the _OpenStorage Library API_ documentation. Here you will find the API functions, examples, and references to multiple client libraries which can communicate with a OpenStorage REST server.
 
+## Status
+This document is under heavy development. Please check back for the latest changes.

docs/SUMMARY.md

@@ -1,6 +1,18 @@
-# Summary
-
+### Concepts
 * [Introduction](README.md)
-    * [Test Code](Code.md)
-	* [More Info](More.md)
-* [Last](Last.md)
+
+### Reference
+* [API Reference](api.md)
+    * [Clusters](clusters/README.md)
+        * [alerts](clusters/alerts.md)
+        * [enumerate](clusters/enumerate.md)
+        * [get node id from ip](clusters/getnodeidfromip.md)
+        * [inspect](clusters/inspect.md)
+        * [status](clusters/status.md)
+        * [versions](clusters/versions.md)
+    * [Volumes](volumes/README.md)
+
+### Examples - Please ignore
+* [_Website tests](Code.md)
+	* [_WebTest](More.md)
+    * [Last](Last.md)

docs/api.md

@@ -0,0 +1 @@
+# API Information

docs/clusters/README.md

@@ -0,0 +1,37 @@
+# Clusters
+
+These set of APIs manage cluster information.
+
+## Overview
+The cluster API is used to interact with the cluster as whole. You will need to create a cluster client to be able to interact with the server and utilize the functions described in this chapter.
+
+### Creating a client
+Below shows examples of how to create a client in multiple languages:
+
+{% codetabs name="Golang", type="go" -%}
+import (
+    clusterclient "github.com/libopenstorage/openstorage/api/client/cluster"
+	"github.com/libopenstorage/openstorage/cluster"
+)
+
+// Create a client setup to talk to a specific node URL
+c, err := clusterclient.NewClusterClient(url, "v1")
+if err != nil {
+    return err
+}
+
+// Create a manager which is an implementation of the
+// cluster.Cluster interface
+m := clusterclient.ClusterManager(c)
+
+// Example - Enumerate
+resp, err := m.Enumerate()
+
+{%- language name="Python", type="py" -%}
+TBD
+{%- endcodetabs %}
+
+
+## Reference
+
+* [Golang](https://godoc.org/github.com/libopenstorage/openstorage/cluster#Cluster)

docs/clusters/alerts.md

@@ -0,0 +1 @@
+# Alerts

docs/clusters/enumerate.md

@@ -0,0 +1 @@
+# Enumerate

docs/clusters/getnodeidfromip.md

@@ -0,0 +1 @@
+# Get node ID from IP

docs/clusters/inspect.md

@@ -0,0 +1 @@
+# Inspect

docs/clusters/status.md

@@ -0,0 +1 @@
+# Status

docs/clusters/versions.md

@@ -0,0 +1 @@
+# Versions