Let's document these ```types``` somewhere on the API doc