Dev guide 03 portlets 6.2

Portlets chapter updated for 6.2, some problems were encountered and noted in the JIRA ticket ant the chapter itself as markdown comments.