Reorg, add, & update content on page "Getting started with functions"

Author: rh-max

modules/functions-list-kn.adoc

@@ -1,6 +1,6 @@
 // Module included in the following assemblies
 
-// * /serverless/cli_reference/kn-func-ref.adoc
+// * /serverless/cli_tools/kn-func-ref.adoc
 
 :_content-type: PROCEDURE
 [id="functions-list-kn_{context}"]

modules/serverless-functions-creating-on-cluster-builds.adoc

@@ -1,6 +1,6 @@
 // Module included in the following assemblies:
 //
-// * /serverless/functions/serverless-functions-getting-started.adoc
+// * /serverless/functions/serverless-functions-on-cluster-builds.adoc
 
 :_content-type: PROCEDURE
 [id="serverless-functions-creating-on-cluster-builds_{context}"]

modules/delete-function-kn.adoc renamed to modules/serverless-kn-func-delete.adoc

@@ -1,12 +1,12 @@
 // Module included in the following assemblies
 
-// * /serverless/cli_reference/kn-func-ref.adoc
+// * serverless/cli_tools/kn-func-ref.adoc
 
 :_content-type: PROCEDURE
-[id="delete-function-kn_{context}"]
+[id="serverless-kn-func-delete_{context}"]
 = Deleting a function
 
-You can delete a function from your cluster by using the `kn func delete` command.
+You can delete a function by using the `kn func delete` command. This is useful when a function is no longer required, and can help to save resources on your cluster.
 
 .Procedure
 

modules/serverless-kn-func-invoke.adoc

@@ -1,13 +1,13 @@
 // Module included in the following assemblies:
 //
 // * serverless/functions/serverless-functions-getting-started.adoc
-// * serverless/reference/kn-func-ref.adoc
+// * serverless/cli_tools/kn-func-ref.adoc
 
 :_content-type: PROCEDURE
 [id="serverless-kn-func-invoke_{context}"]
 = Invoking a deployed function with a test event
 
-You can use the `kn func invoke` CLI command to send a test request to invoke a function either locally or on your {product-title} cluster. This command can be used to test that a function is working and able to receive events correctly.
+You can use the `kn func invoke` CLI command to send a test request to invoke a function either locally or on your {product-title} cluster. You can use this command to test that a function is working and able to receive events correctly. Invoking a function locally is useful for a quick test during function development. Invoking a function on the cluster is useful for testing that is closer to the production environment.
 
 .Prerequisites
 
@@ -24,4 +24,5 @@ You can use the `kn func invoke` CLI command to send a test request to invoke a
 ----
 $ kn func invoke
 ----
+** The `kn func invoke` command only works when there is either a local container image currently running, or when there is a function deployed in the cluster.
 ** The `kn func invoke` command executes on the local directory by default, and assumes that this directory is a function project.

serverless/cli_tools/kn-func-ref.adoc

@@ -14,4 +14,4 @@ include::modules/functions-list-kn.adoc[leveloffset=+1]
 include::modules/describe-function-kn.adoc[leveloffset=+1]
 include::modules/serverless-kn-func-invoke.adoc[leveloffset=+1]
 include::modules/serverless-kn-func-invoke-reference.adoc[leveloffset=+2]
-include::modules/delete-function-kn.adoc[leveloffset=+1]
+include::modules/serverless-kn-func-delete.adoc[leveloffset=+1]

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

@@ -21,6 +21,7 @@ include::modules/serverless-kn-func-run.adoc[leveloffset=+1]
 include::modules/serverless-build-func-kn.adoc[leveloffset=+1]
 include::modules/serverless-deploy-func-kn.adoc[leveloffset=+1]
 include::modules/serverless-kn-func-invoke.adoc[leveloffset=+1]
+include::modules/serverless-kn-func-delete.adoc[leveloffset=+1]
 
 ifdef::openshift-enterprise[]
 [id="additional-resources_serverless-functions-getting-started"]