docs/smoketest.md

Spacer Title

Hidden smoketest page

Use this page to test your changes and ensure that there are not any issues, unwanted behaviors, or regression that are caused by your changes.

Below are a set of site elements that have causes issues in the past.

Lists

• Top level:
  1. A nested list item.
     1. another level lower
  2. Nested code sample:
     Shortcode: {{< readfile file="./hack/reference-docs-gen-config.json" code="true" lang="json" >}}
     Example: {{< readfile file="./hack/reference-docs-gen-config.json" code="true" lang="json" >}}
  3. This should be the third bullet (3.).
     1. More nested code:
        Shortcode: {{< readfile file="Gopkg.toml" code="true" lang="toml" >}}
        Example: {{< readfile file="Gopkg.toml" code="true" lang="toml" >}}
     2. Another nested ordered list item (2.)

Code samples

The following use the readfile shortcode

{{< readfile file="hack/reference-docs-gen-config.json" code="true" lang="json" >}}

{{< readfile file="Gopkg.toml" code="true" lang="toml" >}}

Install version numbers and Clone branch commands

Examples of how the manual and dynamic version number or branch name can be added in-line with the version shortcode (uses the define values from config/_default/params.toml)

1. Shortcode: {{% version %}}

   Example: kubectl apply version/{{% version %}}/is-the-latest/docs-version.yaml

2. Shortcode: {{% version override="v0.2.2" %}}

   Example: kubectl apply the-version-override/{{% version override="v0.2.2" %}}/is-manually-specified.yaml

3. Shortcode: {{% version patch=".20" %}}

   Example: kubectl apply this-is-a-point-release/{{% version patch=".20" %}}/filename.yaml

4. Shortcode: {{% branch %}}

   Example: git clone -b "{{% branch %}}" https://github.com/knative/docs knative-docs

5. Shortcode: {{% branch override="release-0.NEXT" %}}

   Example: git clone -b "{{% branch override="release-0.NEXT" %}}" https://github.com/knative/docs knative-docs