overhaul docs, presentation and organisation