This, and the validation details I could add in, raises one question for me. If we want to keep the Model objects and Serializers as private implementation details of this API, I could see documenting all the details of the models and validation in the API, otherwise I would suggest outlining validation details and model definitions in the related files, and linking the documentation.