add docs w/ examples #75

__Warning__ Filled with typos!
CC @aismai @valentinzberea @skidding @arcade