fix: add comment in asyncapi.md for validation

Changes:

- added comments in the file as suggested by Sergio here: #957 (comment)
- more comments to be adjusted according to the json format