Clarify links, add functions to catalog

Author: prachirp

Makefile

@@ -74,11 +74,15 @@ functions-examples-docker:
 	docker build . -f functions/examples/Dockerfile -t gcr.io/kpt-dev/example-functions:v0.1.0
 	docker push gcr.io/kpt-dev/example-functions:v0.1.0
 
+gencatalog:
+	rm site/content/en/guides/consumer/function/catalog/_index.md
+	(cd site/content/en/guides/consumer/function/catalog/catalog && npm run gen-docs)
+
 gendocs:
 	rm -rf docs/
 	(cd site && go run github.com/gohugoio/hugo)
 
-docs: gendocs license
+docs: gencatalog gendocs license
 
 servedocs:
 	(cd site && go run github.com/gohugoio/hugo server)

README.md

@@ -47,12 +47,13 @@ chmod +x kpt
 GO111MODULE=on go get -v github.com/GoogleContainerTools/kpt
 ```
 
-### [Documentation](https://googlecontainertools.github.io/kpt)
+### [Documentation][docs]
 
-See the [docs](https://googlecontainertools.github.io/kpt) for more information on how to use `kpt`.
+See the [docs] for more information on how to use `kpt`.
 
 ---
 
 [linux]: https://storage.googleapis.com/kpt-dev/latest/linux_amd64/kpt
 [darwin]: https://storage.googleapis.com/kpt-dev/latest/darwin_amd64/kpt
 [windows]: https://storage.googleapis.com/kpt-dev/latest/windows_amd64/kpt.exe
+[docs]: https://googlecontainertools.github.io/kpt

docs/api-reference/index.html

@@ -301,7 +301,7 @@ <h5>
 <ul class="list-inline mb-0">
 
   <li class="list-inline-item mx-2 h3" data-toggle="tooltip" data-placement="top" title="User mailing list" aria-label="User mailing list">
-    <a class="text-white" target="_blank" href="https://groups.google.com/forum/#!forum/kpt-users">
+    <a class="text-white" target="_blank" href="https://groups.google.com/g/kpt-users">
       <i class="fa fa-envelope"></i>
     </a>
   </li>

docs/api-reference/kptfile/index.html

@@ -320,7 +320,7 @@ <h1>Kptfile</h1>
 <ul class="list-inline mb-0">
 
   <li class="list-inline-item mx-2 h3" data-toggle="tooltip" data-placement="top" title="User mailing list" aria-label="User mailing list">
-    <a class="text-white" target="_blank" href="https://groups.google.com/forum/#!forum/kpt-users">
+    <a class="text-white" target="_blank" href="https://groups.google.com/g/kpt-users">
       <i class="fa fa-envelope"></i>
     </a>
   </li>

docs/concepts/api-conventions/index.html

@@ -473,7 +473,7 @@ <h2 id="next-steps">Next Steps</h2>
 <ul class="list-inline mb-0">
 
   <li class="list-inline-item mx-2 h3" data-toggle="tooltip" data-placement="top" title="User mailing list" aria-label="User mailing list">
-    <a class="text-white" target="_blank" href="https://groups.google.com/forum/#!forum/kpt-users">
+    <a class="text-white" target="_blank" href="https://groups.google.com/g/kpt-users">
       <i class="fa fa-envelope"></i>
     </a>
   </li>

docs/concepts/architecture/index.html

@@ -389,6 +389,9 @@ <h4 id="configuration-as-data">Configuration as data</h4>
 As configuration becomes complex, it becomes hard to read and understand.
 Our design philosophy is to keep configuration as data in order to manage this complexity.
 We do this by keeping resources serialized as either JSON or YAML configuration.</p>
+<ul>
+<li><a href="https://changelog.com/gotime/114#t=00:12:09.18">link</a></li>
+</ul>
 <h4 id="kpt-vs-kubernetes">kpt vs kubernetes:</h4>
 <ul>
 <li>While the Kubernetes control-plane reads / writes configuration data stored by the apiserver
@@ -585,7 +588,7 @@ <h3 id="targets">Targets</h3>
 <ul class="list-inline mb-0">
 
   <li class="list-inline-item mx-2 h3" data-toggle="tooltip" data-placement="top" title="User mailing list" aria-label="User mailing list">
-    <a class="text-white" target="_blank" href="https://groups.google.com/forum/#!forum/kpt-users">
+    <a class="text-white" target="_blank" href="https://groups.google.com/g/kpt-users">
       <i class="fa fa-envelope"></i>
     </a>
   </li>

docs/concepts/functions/index.html

@@ -415,8 +415,9 @@ <h3 id="pipeline">Pipeline</h3>
 
 <h2 id="next-steps">Next Steps</h2>
 <ul>
+<li>Get a quickstart on writing functions from the <a href="../../guides/producer/functions/">function producer docs</a>.</li>
 <li>See more examples of functions in the functions <a href="../../guides/consumer/function/catalog">catalog</a>.</li>
-<li>Consult the <a href="../../guides/producer/functions/">function producer docs</a> for more details on writing functions.</li>
+<li>Learn more ways of using the <code>kpt fn</code> command from the <a href="../../reference/fn/run/">reference</a> doc.</li>
 </ul>
 
         <div class="section-index">
@@ -459,7 +460,7 @@ <h2 id="next-steps">Next Steps</h2>
 <ul class="list-inline mb-0">
 
   <li class="list-inline-item mx-2 h3" data-toggle="tooltip" data-placement="top" title="User mailing list" aria-label="User mailing list">
-    <a class="text-white" target="_blank" href="https://groups.google.com/forum/#!forum/kpt-users">
+    <a class="text-white" target="_blank" href="https://groups.google.com/g/kpt-users">
       <i class="fa fa-envelope"></i>
     </a>
   </li>

docs/concepts/index.html

@@ -397,7 +397,7 @@ <h5>
 <ul class="list-inline mb-0">
 
   <li class="list-inline-item mx-2 h3" data-toggle="tooltip" data-placement="top" title="User mailing list" aria-label="User mailing list">
-    <a class="text-white" target="_blank" href="https://groups.google.com/forum/#!forum/kpt-users">
+    <a class="text-white" target="_blank" href="https://groups.google.com/g/kpt-users">
       <i class="fa fa-envelope"></i>
     </a>
   </li>

docs/concepts/packaging/index.html

@@ -394,7 +394,7 @@ <h2 id="packaging">Packaging</h2>
 <ul class="list-inline mb-0">
 
   <li class="list-inline-item mx-2 h3" data-toggle="tooltip" data-placement="top" title="User mailing list" aria-label="User mailing list">
-    <a class="text-white" target="_blank" href="https://groups.google.com/forum/#!forum/kpt-users">
+    <a class="text-white" target="_blank" href="https://groups.google.com/g/kpt-users">
       <i class="fa fa-envelope"></i>
     </a>
   </li>

docs/contact/index.html

@@ -237,7 +237,7 @@ <h1>Contact</h1>
 <p>We&rsquo;d love to hear from you!</p>
 <ul>
 <li>Join our <a href="https://kubernetes.slack.com/channels/kpt">Slack channel</a></li>
-<li>Join our <a href="https://groups.google.com/forum/#!forum/kpt-users">email list</a></li>
+<li>Join our <a href="https://groups.google.com/g/kpt-users">email list</a></li>
 </ul>
 
         <div class="section-index">
@@ -272,7 +272,7 @@ <h1>Contact</h1>
 <ul class="list-inline mb-0">
 
   <li class="list-inline-item mx-2 h3" data-toggle="tooltip" data-placement="top" title="User mailing list" aria-label="User mailing list">
-    <a class="text-white" target="_blank" href="https://groups.google.com/forum/#!forum/kpt-users">
+    <a class="text-white" target="_blank" href="https://groups.google.com/g/kpt-users">
       <i class="fa fa-envelope"></i>
     </a>
   </li>