Merge branch 'master' into gatekeeper/v0.1

Author: Mengqi Yu

.github/hooks/pre-commit

@@ -9,5 +9,7 @@ node_modules
 bin/
 __pycache__
 
+functions/go/*/generated
+
 # We use sed -i.bak when doing in-line replace, because it works better cross-platform
 *.bak

.gitignore

@@ -3,21 +3,25 @@
 ### Overview
 
 1. Explain what this particular example demonstrates.
-2. Include a link to the function reference (help doc) on first mention of the function.
-3. If function config present:
+1. Include a link to the function reference (help doc) on first mention of the function.
+
+### Fetch the example package
+
+1. Show exact `kpt` commands to get the example package.
+1. If function config present:
     1. Show the example function config.
     1. Explain what this function config does.
     Focus on explaining this particular example, not repeating the function reference.
 
 ### Function invocation
 
-4. Show exact `kpt` commands to get the example package and run the function.
+1. Show exact `kpt` commands to run the function.
 
 ### Expected result
 
-5. Describe the expected outcome of running the instructions above. This needs to be specific enough
+1. Describe the expected outcome of running the instructions above. This needs to be specific enough
  so that the user is confident the function works as expected (Don't just provide the command to `cat` a file).
 
 ### Function Reference
 
-6. Provide a link to the function help doc for reference.
+1. Provide a link to the function help doc for reference.

examples/_template/README.md

@@ -8,6 +8,14 @@ with setter references.
 In this example, we will see how to apply desired setter values to the 
 resource fields parameterized by `kpt-set` comments.
 
+### Fetch the example package
+
+Get the example package by running the following commands:
+
+```shell
+$ kpt pkg get https://github.com/GoogleContainerTools/kpt-functions-catalog.git/examples/apply-setters-simple
+```
+
 Let's start with the input resources
 
 ```yaml
@@ -68,11 +76,10 @@ roles: # kpt-set: ${role}
 
 ### Function invocation
 
-Get the config example and try it out by running the following commands:
+Invoke the function by running the following commands:
 
 ```shell
-$ kpt pkg get https://github.com/GoogleContainerTools/kpt-functions-catalog.git/examples/apply-setters/simple
-$ kpt fn render simple
+$ kpt fn render apply-setters-simple
 ```
 
 ### Expected result