I am deeply sorry that the swagger documentation does not fill your expectances, I would recommend you to dig into the http methods to understand them and understand the documentation better, I am not the one who writes the documentation, but I guess that is developed for who has a minimum knowledge related, for sure it would be a titanic task to write a documentation for general public, and I dont think that is the goal of the project’s developers.
Here is an example I made a long time ago in php, note that I am not a web developer and for sure it can be improved in many ways and has a lack of good practices, but maybe it can help you
Hope this helps.