private/model/api: Improve SDK API doc generation

[jasdel]

The SDK's API doc generation has several issues with spacing, newlines, and indention. The v2 SDK's generation logic needs to be updated based on the improvements made to the v1 SDK's logic.

Port: aws/aws-sdk-go#2617