Alpine containers don't have bash, so need to change the first line.

Introductory guide for newcomers. This is a two-file quickstart that
shows a simple example to create a task and a pipeline.

These tutorials do not include new information. The information here is
reorganized to be easier to understand for newcomers. Including
prescritpive steps that the user just has to copy/paste .

Currently the netlify deploy uses hugo v0.53, which is almost 4 years
old and has some big inconsistencies when rendering markdown. This bumps
hugo up to the latest release.

The current version of Jinja2 cases issues with the transitive
dependency markupsafe. Updating to a recent version fixes the
issue.
Signed-off-by: NAndrea Frittoli <andrea.frittoli@gmail.com>

Pipeline v0.33.0 was released today.
Add the docs for the last four versions of pipeline - it was not updated
since v0.29.x.

Using v0.33.x as display name so that we don't need to update the sync
config on minor releases.
Signed-off-by: NAndrea Frittoli <andrea.frittoli@gmail.com>

Workadound for https://github.com/tektoncd/triggers/issues/1306 until
the fix is merged on triggers side.
Signed-off-by: NAndrea Frittoli <andrea.frittoli@gmail.com>

Step 1: Restore the previous reference output and adapt the Task YAML to match it

Accordingly add the version tag to the `image` key in the YAML

The version of `pytest` specified in `dev_requirements.txt` is incompatible with Python 3.10. In order to make the Katacoda experience as reproducible as possible, it’s a good practice to use fixed versions for as many things as possible anyway.

Signed-off-by: NVille Aikas <vaikas@chainguard.dev>

Currently only points at main. Tagged released docs will come later.

- Move the contribution guidelines to the documentation folder so they
  show up in the website. Some minor updates were introduced to reflect
  the agreements about documentation strategy.

- Update the roadmap. It now includes the main points agreed about the
  docs strategy going forward.

Thank you Geri for your contributions to the Docs WG!!
The community PR is merged https://github.com/tektoncd/community/pull/562
This one is to keep the OWNERS file in sync.
Signed-off-by: NAndrea Frittoli <andrea.frittoli@gmail.com>

Add configuration for chain docs.
Front matter is missing so adding some basic one just to test the
PR. The docs include images at least one image (the logo) which
does not work as the only mime type supported for in-repo data is
text / markdown - which is something we need to fix in the sync
script.

This also adds support for using "." to get documents from the
repo root.
Signed-off-by: NAndrea Frittoli <andrea.frittoli@gmail.com>

Documentation may contain links to local files which are neither
text/markdown nor text/plain. Add support for those file by loading
them as binary (no decoding) and writing them as-is as binary in
the target location.
Signed-off-by: NAndrea Frittoli <andrea.frittoli@gmail.com>

displayOrder and docDirectory are not used anymore by the sync
script, so remove them from config, docs and tests.

The default target is now "" and not "/" anymore, so fix a few
comments where it referred to the old value.
Signed-off-by: NAndrea Frittoli <andrea.frittoli@gmail.com>

Release v0.25.x branch has been created on pipeline side to add
documentation updates. Switch the config to the branch so that
we pull in any doc updates.
Signed-off-by: NAndrea Frittoli <andrea.frittoli@gmail.com>

Add the netlify-plugin-checklinks plugin to check for broken
links on deploy.
Signed-off-by: NAndrea Frittoli <andrea.frittoli@gmail.com>

Hugo supports markdown emojis in the :<name>: format by they are
disabled by default. Enable them as might be used in Tekton docs.

Fixes #268
Signed-off-by: NAndrea Frittoli <andrea.frittoli@gmail.com>

When similar links are present in a single page, under certain
conditions links were rewritten twice, causing broken links.
Fix that by replacing (<original-link>) with parenthesys now.

Fixes #279
Signed-off-by: NAndrea Frittoli <andrea.frittoli@gmail.com>

We used to check for reference names in the sync script, which required
the branch name to be configured as "origin/<branch-name>".
This approach broke some of the links.
Fix the sync script by looking for remote ref names in the python git
wrapper, and changing all config to use branch name only.

Fixes #313
Signed-off-by: NAndrea Frittoli <andrea.frittoli@gmail.com>

Add the docs for triggers v0.17 and updated v0.16 to v0.16.1
Signed-off-by: NAndrea Frittoli <andrea.frittoli@gmail.com>

Signed-off-by: NShivam Mukhade <smukhade@redhat.com>

Signed-off-by: NAndrea Frittoli <andrea.frittoli@gmail.com>

fixes #205

Delete dangling div tag in the tutorial shortcode code that causes the
footer to not render correctly in some pages.

sync/sync.py fails if the installed git version is older than 1.8.5.
That is because sync/sync.py calls git command with -C option internally,and the option was
introduced at git 1.8.5. 1.8.5 is quite old but the default git version is older than it in certain
Linux distribution. Adding git version prerequisite could be more developer-friendly.

The Kubernetes environment provided by Katacoda is version 1.18. Tekton Pipelines
releases from v0.27 require a minimum of Kubernetes 1.19. Since the tutorials
currently install the 'latest' release this means they are broken.

Pin the Pipelines release version to v0.26 since this is last release that supports
Kubernetes 1.18. In future we may need to adopt a different approach to building
these tutorial environments so we have more flexibility on the Kubernetes version.

The documents were missing a few releases, I added them to the config
file.

The config file points to the release branch when available, otherwise
it uses the release tag.

Running the site locally requires installing a lot of dependecies
spanning Python, Go, and Node packages; this can be dauting. Dockerizing
the website reduces the dependencies to one, in a reproducible
environment.

I used the same base image as the docy-example site. Two images are
created, the first one installs the python requirements for the sync
script, then runs the sync script. The second one runs the website and
mounts the folder as a volume inside the container.

Bumps [jinja2](https://github.com/pallets/jinja) from 2.11.1 to 2.11.3.
- [Release notes](https://github.com/pallets/jinja/releases)
- [Changelog](https://github.com/pallets/jinja/blob/master/CHANGES.rst)
- [Commits](https://github.com/pallets/jinja/compare/2.11.1...2.11.3)
Signed-off-by: Ndependabot[bot] <support@github.com>