updated readme + beginning of docs (preface)