updated README with some recommended reading
added spec document