Tekton API Reference

[skaegi]

Currently a lot of our doc is examples that do not necessarily reflect all the dark corners of our API. It might be time to craft or generate open API for everything and add a reference API section to our doc.

Something like -- https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.15/

[duanshiqiang]

Yes, it would be very useful.

[bobcatfish]

Going to close this as a duplicate of #2055 which has an open PR against it currently and covers the same thing

I'm going to reopen this one since #2055 ended up in a closed state. If I remember right, though I can't find the specific PR, we decided that a static description of the API wasn't enough and that we wanted to be able to regenerate the API documentation. This issue describes that requirement a bit more clearly than #2055 so I'm calling this one the source of truth. Happy to switch it around again if others prefer.