The Portal Framework (http://localhost:8888/samples/portal-fw/) is considered to be "obsolete", in that it is being replaced with the new PortalEngine.
Some docs are available in the stock Cocoon installation, here: http://localhost:8888/docs/developing/webapps/portal.html