Mentorship-backend: Swagger UI is not being generated

[isabelcosta]

Describe the bug

After the latest merge https://github.com/systers/mentorship-backend/pull/158 the Swagger UI is not being generated.

The API is working, and it can be tested using other tools and the Android client, but this is bad for who wants to test the backend API without additional tools (like Postman).

To Reproduce
Steps to reproduce the behavior:

1. Go to http://systers-mentorship-dev.eu-central-1.elasticbeanstalk.com/
2. You won't see the Swagger UI generated

Expected behavior

Swagger UI should appear.

Screenshots

This is what is showing up:

This should show up:

Additional context

The problem was introduced here: https://github.com/systers/mentorship-backend/pull/158
I'm looking at this but any help would be appreciated.

The problem is with the usage of flask restplus. See the docs here: https://flask-restplus.readthedocs.io/en/stable/

[isabelcosta]

I'm thinking this could be related with the use of field.Nested:

Investigating ...

[isabelcosta]

By commenting on this line of code Swagger UI will be generated.

As you can see below:

[isabelcosta]

It's fixed, by adding this missing description :D