readme documentation (work in progress)