restructure docs; add point calculation
merge