Added small note about generalizing comment types
Updated API Specification to include pagination of comments as discussed in pull request #16