Clarify and document the purpose of data files
There are a number of data files with unclear purposes and/or documentation. This causes a lack of transparency and inefficiency. See this example Slack thread.
Let's add better guidance to frequently used templates to clarify the purpose of the data file, with examples of how/where/why it's leveraged. This should be done in the data files themselves for ease of access, with links out to more elaborate content in the handbook if needed. We can start by reviewing these data files and add more as we sweep the repository:
-
features.yml -
stages.yml -
categories.yml -
features_v2.yml -
devops_tools.yml -
uncategorized devops_tools.yml