We're using Swagger incorporated with Flask-Restful, which has been quite straightforward to setup and maintain. I like ReadMe, but I feel like it needs stronger integrations to be compelling - e.g. autogenerating code examples for various languages.