We noticed that users and contributors of cloud native projects care a lot about why a certain technical decision was taken.
In our Kubernetes distribution, we use Markdown Any Decision Records. In essence, you create a folder docs/adr with a file template.md. Then you copy the template for each decision you take. Here is an example on how this would look like.
Would it be beneficial to include this in the CNCF project template?