docs: Fix naming consistency, typos, and improve sample references#2186

Copilot wants to merge 1 commit intomainopenshift-pipelines/pipelines-as-code:mainfrom

copilot/fix-fd1bb711-0831-4261-ae7d-4524f79937fdopenshift-pipelines/pipelines-as-code:copilot/fix-fd1bb711-0831-4261-ae7d-4524f79937fdCopy head branch name to clipboard