Define Glossary

[6543]

based on #745 (comment)

close #1724

[woodpecker-bot]

Deployment of preview was successful: https://woodpecker-ci-woodpecker-pr-1800.surge.sh

[anbraten]

What do you think about moving this to the user docs. I guess it would be quite nice if users would read that to for example be able to ask much better questions in the chat, issues.

[6543]

@anbraten moved, hope it's in a better spot now

[anbraten]

@6543 I had a short look around. And liked how the following pages placed it right after the Getting started area.

• https://docs.gocd.org/current/introduction/concepts_in_go.html
• https://buildkite.com/docs/pipelines/glossary

So between getting started and pipeline syntax, might be a good place:

In addition I checked the search and would suggest we change the terms to headings so they are more important in the search and the user can use easily navigate them and then use the links you have added to navigate to the corresponding pages after getting a short introduction of that term.

Extending to something like those concepts & philosophy pages could be nice in the future as well:

• https://circleci.com/docs/concepts/
• https://tekton.dev/docs/concepts/overview/
• https://kraken.ci/docs/philosophy

Also really nice is how argo structed their docs in a tranining / like a course way. So you learn step by step more advanced concepts of the tool:

• https://argoproj.github.io/argo-workflows/walk-through/