[srvls] Add kn func CLI docs

Author: abrennan89

_topic_map.yml

@@ -3005,3 +3005,5 @@ Topics:
     File: kn-flags-reference
   - Name: kn service
     File: kn-services-ref
+#  - Name: kn func
+#    File: kn-func-ref

modules/delete-function-kn.adoc

@@ -0,0 +1,19 @@
+// Module included in the following assemblies
+
+// * /serverless/cli_reference/kn-func-ref.adoc
+
+[id="delete-function-kn_{context}"]
+= Deleting a function
+
+You can delete a function from your cluster by using the `kn func delete` command.
+
+.Procedure
+
+* Delete a function:
++
+[source,terminal]
+----
+$ kn func delete [<function_name> -n <namespace> -p <path>]
+----
+** If the name or path of the function to delete is not specified, the current directory is searched for a `func.yaml` file that is used to determine the function to delete.
+** If the namespace is not specified, it defaults to the `namespace` value in the `func.yaml` file.

modules/describe-function-kn.adoc

@@ -0,0 +1,38 @@
+// Module included in the following assemblies
+
+// * /serverless/cli_reference/kn-func-ref.adoc
+
+[id="describe-function-kn_{context}"]
+= Describing a function
+
+The `kn func describe` command prints information about a deployed function, such as the function name, image, namespace, information about the Knative service, route information, and event subscriptions.
+
+.Procedure
+
+* Describe a function:
++
+[source,termnal]
+----
+$ kn func describe [-f <format> -n <namespace> -p <path>]
+----
++
+.Example command
+[source,terminal]
+----
+$ kn func describe -p function/example-function
+----
++
+.Example output
+[source,terminal]
+----
+Function name:
+  example-function
+Function is built in image:
+  docker.io/user/example-function:latest
+Function is deployed as Knative Service:
+  example-function
+Function is deployed in namespace:
+  default
+Routes:
+  http://example-function.default.apps.ci-ln-g9f36hb-d5d6b.origin-ci-int-aws.dev.rhcloud.com
+----

modules/functions-list-kn.adoc

@@ -0,0 +1,39 @@
+// Module included in the following assemblies
+
+// * /serverless/cli_reference/kn-func-ref.adoc
+
+[id="functions-list-kn_{context}"]
+= Listing existing functions
+
+You can list existing functions by using `kn func list`. If you want to list functions that have been deployed as Knative services, you can also use `kn service list`.
+
+.Procedure
+
+* List existing functions:
++
+[source,terminal]
+----
+$ kn func list [-n <namespace> -p <path>]
+----
++
+.Example output
+[source,terminal]
+----
+NAME           NAMESPACE  RUNTIME  URL                                                                                      READY
+example-function  default    node     http://example-function.default.apps.ci-ln-g9f36hb-d5d6b.origin-ci-int-aws.dev.rhcloud.com  True
+
+----
+
+* List functions deployed as Knative services:
++
+[source,terminal]
+----
+$ kn service list -n <namespace>
+----
++
+.Example output
+[source,terminal]
+----
+NAME            URL                                                                                       LATEST                AGE   CONDITIONS   READY   REASON
+example-function   http://example-function.default.apps.ci-ln-g9f36hb-d5d6b.origin-ci-int-aws.dev.rhcloud.com   example-function-gzl4c   16m   3 OK / 3     True
+----

modules/serverless-build-func-kn.adoc

@@ -10,7 +10,7 @@ Before you can run a function, you must build the function project by using the
 .Example `func.yaml`
 [source,yaml]
 ----
-name: fn.example.io
+name: example-function
 namespace: default
 runtime: node
 image: <image_from_registry>
@@ -34,7 +34,7 @@ $ kn func build [-i <image> -r <registry> -p <path>]
 [source,terminal]
 ----
 Building function image
-Function image has been built, image: quay.io/username/fn.example.io:latest
+Function image has been built, image: quay.io/username/example-function:latest
 ----
 
 This command creates an OCI container image that can be run locally on your computer, or on a Kubernetes cluster.
@@ -47,7 +47,7 @@ A registry for function images is required (e.g. 'quay.io/boson').
 
 Registry for function images: quay.io/username
 Building function image
-Function image has been built, image: quay.io/username/fn.example.io:latest
+Function image has been built, image: quay.io/username/example-function:latest
 ----
 
 The values for image and registry are persisted to the `func.yaml` file, so that subsequent invocations do not require the user to specify these again.

modules/serverless-create-func-kn.adoc

@@ -14,7 +14,7 @@ The values provided for image and registry are persisted to the `func.yaml` file
 .Example `func.yaml`
 [source,yaml]
 ----
-name: fn.example.io
+name: example-function
 namespace: default
 runtime: node
 image: <image_from_registry>
@@ -40,14 +40,14 @@ $ kn func create <path> -r <registry> -l <runtime> -t <trigger> -i <image> -n <n
 .Example command
 [source,terminal]
 ----
-$ kn func create functions/fn.example.io
+$ kn func create functions/example-function
 ----
 +
 .Example output
 [source,terminal]
 ----
-Project path: /home/user/functions/fn.example.io
-Function name: fn.example.io
+Project path: /home/user/functions/example-function
+Function name: example-function
 Runtime: node
 Trigger: http
 ----

serverless/cli_reference/kn-func-ref.adoc

@@ -0,0 +1,14 @@
+include::modules/serverless-document-attributes.adoc[]
+[id="kn-func-ref"]
+= kn func
+:context: kn-func-ref
+include::modules/common-attributes.adoc[]
+
+toc::[]
+
+include::modules/serverless-create-func-kn.adoc[leveloffset=+1]
+include::modules/serverless-build-func-kn.adoc[leveloffset=+1]
+include::modules/serverless-deploy-func-kn.adoc[leveloffset=+1]
+include::modules/functions-list-kn.adoc[leveloffset=+1]
+include::modules/describe-function-kn.adoc[leveloffset=+1]
+include::modules/delete-function-kn.adoc[leveloffset=+1]

serverless/functions/serverless-functions-getting-started.adoc

@@ -20,3 +20,8 @@ Before you can complete the following procedures, you must ensure that you have
 include::modules/serverless-create-func-kn.adoc[leveloffset=+1]
 include::modules/serverless-build-func-kn.adoc[leveloffset=+1]
 include::modules/serverless-deploy-func-kn.adoc[leveloffset=+1]
+
+[id="additional-resources_serverless-functions-getting-started"]
+== Additional resources
+
+* See the reference documentation for xref:../../serverless/cli_reference/kn-func-ref.adoc#kn-func-ref[`kn func`].