We need some documentation, but I am not sure if it will live here or with the api docs... will add more info here.