moved docs to proper place. rewrote docs using common terms.