Coming into this exercise and trying to read the docs and port a test is that I see many other fields referenced in the configs you have already ported versus what is shown in the design docs. For example; tests (global) has the following fields which are not touched on in the design docs: drone_dimensions, recipe, gclient_variables (which can be used in a build but now shown in the tests objects), test_dependencies and dependencies.
The docs need to be more detailed and adding all possible fields with descriptions will help the users to use this framework.