specs and api-doc with examples for holidays-controller