Hi, CTO of Mashape here. I'm sorry to hear you had a bad experience when writing the docs, we'll definitely improve the workflow and make it easier to understand.

In the meanwhile, I documented your API with my account, and I would be happy to transfer it to yours if you like. Here it is: http://www.mashape.com/thefosk/heck-yes-markdown

The documentation it is really a documentation, not all the fields are mandatory by the system, except the endpoint URL, and the parameter's name (we need them to auto-generate the client libraries). All the other fields are optional and provided just for the sake of understandability when a third party needs to consume your API.