MDL-18734 - documentation and coding style in portfolio/*