ADT API - Review comments and changes

Thanks for getting this section ready for the release.

I let some of the paragraph lines run short/long of 80 columns so that it'd be easier to see my wordsmith changes. But you'll want to wrap them to 80 after looking them over.

Please see the changes I made to the properties referenced in the Recommendations section. I didn't want to specify the properties with their default assignments for two reasons: 1) so we don't have to maintain default values if they change. 2) so that readers don't think they are to copy any assignments. They should review the descriptions of each portal property and override any values as they see fit. Note, I'm not sure the best format for listing properties (maybe using bullets would be better). 

Let me know if you have any questions. Thanks.