updated portal design doc