initial docs re-write