uppercase is simply to conform with gitlab's requirements.

also make sure relevant documents (contributing, running, etc) are first in the TOC