Merge pull request #261 from arewm/sample-repositories

add sample repositories to references

Author: arewm

modules/ROOT/pages/reference/_nav.adoc

@@ -1,4 +1,5 @@
 * xref:reference/index.adoc[Reference]
+** xref:reference/sample-repositories.adoc[Sample repositories]
 ** xref:reference/kube-apis/index.adoc[Konflux Kubernetes APIs]
 *** xref:reference/kube-apis/application-api.adoc#k8s-api-github-com-konflux-ci-application-api-api-v1alpha1-application[Application]
 *** xref:reference/kube-apis/application-api.adoc#k8s-api-github-com-konflux-ci-application-api-api-v1alpha1-component[Component]

modules/ROOT/pages/reference/index.adoc

@@ -1,8 +1,11 @@
 = Reference
 
-Below you will find links to Konflux reference documentation.
+== Sample repositories
 
-== Konflux Kubernetes APIs
+The xref:reference/sample-repositories.adoc[sample repositories] page contains examples of repositories
+that may be useful for understanding how to work with {ProductName}.
+
+== {ProductName} Kubernetes APIs
 
 The xref:reference/kube-apis/index.adoc[Kubernetes APIs] page contains the specification for all
 Kubernetes API extensions specific to Konflux.

modules/ROOT/pages/reference/sample-repositories.adoc

@@ -0,0 +1,20 @@
+= Sample repositories
+
+There are multiple sample repositories which demonstrate various functionality within {ProductName}. You can
+either use these as reference or you can fork them and try to onboard the repositories yourself.
+
+== Multi-arch
+
+This repository demonstrates the configuration for a simple multi-architecture build.
+
+https://github.com/konflux-ci/multi-arch-konflux-sample
+
+== OLM operator
+
+This repository demonstrates many steps in the onboarding process. It also illustrates
+how to configure builds for multiple components in a single repository as well as building
+code referenced by a git submodule.
+
+https://github.com/konflux-ci/olm-operator-konflux-sample
+
+include::ROOT:partial$reference/{context}-additional-sample-repositories.adoc[]