Same here, at the time they hardly had any documentation, not sure how the situation improved.

We ended up using basic JSPs or servlets, depending on the portlet use case, with the bulk of UI done with jQuery and custom components provided by a designer company.