Add intial readme

Signed-off-by: Alex Ellis <[email protected]>

Author: alexellis

.gitignore

@@ -0,0 +1 @@
+build

README.md

@@ -0,0 +1,90 @@
+OpenFaaS Golang HTTP template
+=============================================
+
+This template provides additional context and control over the HTTP response from your function.
+
+## Status of the template
+
+This template is pre-release and is likely to change - please provide feedback via https://github.com/openfaas/faas
+
+The template makes use of the OpenFaaS incubator project [of-watchdog](https://github.com/openfaas-incubator/of-watchdog).
+
+## Trying the template
+
+```
+$ faas template pull https://github.com/alexellis/golang-http-template
+$ faas new --lang golang-http
+```
+
+## Example usage
+
+Example writing a successful message:
+
+```go
+package function
+
+import (
+	"fmt"
+	"net/http"
+
+	"github.com/openfaas-incubator/go-function-sdk"
+)
+
+// Handle a function invocation
+func Handle(req handler.Request) (handler.Response, error) {
+	var err error
+
+	message := fmt.Sprintf("Hello world, input was: %s", string(req.Body))
+
+	return handler.Response{
+		Body:       []byte(message),
+    }, err
+}
+```
+
+Example writing a custom status code
+
+```go
+package function
+
+import (
+	"fmt"
+	"net/http"
+
+	"github.com/openfaas-incubator/go-function-sdk"
+)
+
+// Handle a function invocation
+func Handle(req handler.Request) (handler.Response, error) {
+	var err error
+
+	return handler.Response{
+		Body:       []byte("Your workload was accepted"),
+		StatusCode: http.StatusAccepted,
+	}, err
+}
+```
+
+Example writing an error / failure.
+
+```go
+package function
+
+import (
+	"fmt"
+	"net/http"
+
+	"github.com/openfaas-incubator/go-function-sdk"
+)
+
+// Handle a function invocation
+func Handle(req handler.Request) (handler.Response, error) {
+	var err error
+
+	return handler.Response{
+        Body: []byte("the input was invalid")
+	}, fmt.Errorf("invalid input")
+}
+```
+
+The error will be logged to `stderr` and the `body` will be written to the client along with a HTTP 500 status code.

template/golang-http/main.go

@@ -36,6 +36,7 @@ func makeRequestHandler() func(http.ResponseWriter, *http.Request) {
 		result, resultErr := function.Handle(req)
 
 		if resultErr != nil {
+			log.Print(resultErr)
 			w.WriteHeader(http.StatusInternalServerError)
 		} else {
 			if result.StatusCode == 0 {