improve documentation, work out conceptual details