Hi Stephen,
RAML is used for validation of REST API calls, since this is mostly for developers, we will try to cover more documentation on it in the future. For now, here is a guide that you can read if you would like to get an idea of how it works.
Regards,
Subject7 Team