LRDOCS-463 portlet chapter review comments addressed.

This is ready to merge with upstream. Thanks.

@jrao