document the Ray API

Signed-off-by: Sébastien Boisvert <sebastien.boisvert.3@ulaval.ca>