Add most recent release `v0.26.x` and `main` as the only options for
now as we've updated the structure and links to ensure they work
correctly on both GitHub and the website.

Add the docs for triggers v0.18.0 & v0.19.0, and updated v0.17.0 to v0.17.1

Updating the website configuration to include the two latest major releases.

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>

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

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>

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>

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>

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.

Track release branches instead of tags in order to sync recent
documentation updates.

Bump displayName to reflect the most recent patch release.

closes: #271

- Add triggers v0.11.2, v0.12.1, v0.13.0, v0.14.1
- Update triggers from v0.10.1 to v0.10.2
- Remove create-webhook.yaml from included files
- Use remote branch refs for trigger docs

- Updating from v0.24.1 to v0.24.3
- Adding v0.25.0

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

Changing links to any reference to tektoncd/pipeline.
Signed-off-by: NVincent Demeester <vdemeest@redhat.com>

Changing links to any reference to tektoncd/triggers.
Signed-off-by: NVincent Demeester <vdemeest@redhat.com>

Changing links to any reference to tektoncd/cli.
Signed-off-by: NVincent Demeester <vdemeest@redhat.com>

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

We missed some updates when releasing the cli, fixing this for current releases.
Signed-off-by: NVincent Demeester <vdemeest@redhat.com>

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

Add v0.10.1 of the docs
Signed-off-by: NAndrea Frittoli <andrea.frittoli@gmail.com>

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

Add the new version and add some docs that were previously excluded:
- deprecations
- runs
- tekton bundles contract

Add an option to update caches.
Signed-off-by: NAndrea Frittoli <andrea.frittoli@gmail.com>

Change the sync configuration from files to folders, so make the
configuration easier to maintain as well to allow syncing folders
of generated docs, where the list of files may vary and for which
it is not possible to pre-add the YAML headers used by docsy.

This change implies the following modification to the sync process:
- we do not download files one-by-one to disk and rewrite them to
  a different location on disk. Instead we git clone all relevant
  repositories, and pull files at the correct reference into the
  site content folder direcly
- we now support pulling content from different folders in the
  tekton repos. As part of the configuration a target folder in
  the website can be specified. The default is '/'.
  This will allow pulling in content from other folders that may
  not even be under `docs`.

As part of the re-work, a couple of issues have been fixed:
- links to the index page were re-written to github because the
  `_index.md` could not be found locally in the source. This case
  is now handled by the code
- links to files in nested folders were re-written to github
  because the files were downloaded to the parent folders and
  thus not found locally. Files configured from a nested folder
  are now downloaded to the configured target folder and the
  check has been fixed.
  In one case this issue had the side effect of fixing the broken
  link in content/en/vault/Triggers-v0.7.0/exposing-eventlisteners.md:
  - [`create-ingress`](./create-ingress.yaml)
  the YAML file is not in the `docs` folder so the link should be:
  - [`create-ingress`](./getting-started/create-ingress.yaml)
  which would have to be fixed on triggers side, with a new minor
  release.

Overall the execution time ("real") has been improved (real), at
least on my laptop. The "user" time is bit more so on systems
with fewer CPU cores it may take slightly longer.

- before:
real	0m41.870s
user	1m52.244s
sys	0m29.440s

- after, no cache:
real	0m31.981s
user	2m25.869s
sys	0m46.176s

- after, with cache:
real	0m21.382s
user	2m24.826s
sys	0m42.637s

Added more unit test coverage (75% now).
To verify this change I also diffed the content generated before
this change with the content generated after the change.
Signed-off-by: NAndrea Frittoli <andrea.frittoli@gmail.com>

Pipeline release v0.17.3 which supercedes v0.17.2.
Updating the docs accordingly.
Signed-off-by: NAndrea Frittoli <andrea.frittoli@gmail.com>

Set the latest version of each component as the current one, add
everything else, including master, to the vault.
Remove the _index.md files that are brought in via sync.
Signed-off-by: NAndrea Frittoli <andrea.frittoli@gmail.com>

Add a new python script that can be used to add a new version to
the configuration of a component.
This script can be used by various projects as part of their
release process to keep the version on the website up-to-date.
Signed-off-by: NAndrea Frittoli <andrea.frittoli@gmail.com>

Cleanup typos, simplify logic in a few places.
Make the list of files config a dict instead of a list of dicts.
Signed-off-by: NAndrea Frittoli <andrea.frittoli@gmail.com>

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

Some of the Triggers content was moved in https://github.com/tektoncd/triggers/pull/642,
specifically: create-ingress.yaml and create-webhook.yaml

These have been moved to the getting-started folder which broke
the website sync script, blocking other changes.

Update the sync config to point to the new paths to unblock
other changes.

- Migrating from v1alpha1 to v1beta1
- Pipeline metrics
- Variable substitution

The samples for the two 'Getting Started' links at the end of the main
Triggers page in the docs are missing so the links result in 404.

Add the YAML files to the sync config so they'll be included and available
from the links on the website.

The initial `_index.md` file of CLI got added to the CLI repository,
so adding the cli repository to the sync script for the future.
Signed-off-by: NVincent Demeester <vdemeest@redhat.com>