make subtitles more readable
integrates example responses as comments