There is a template project that is good to follow to include a few basic markdown files: https://github.com/kubernetes/kubernetes-template-project