document ports and env