second batch of fixes for swagger doc