add docs w/ examples #75

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