update 5

further updates including a draft database description