DOC: updated README with more information

also added doc directory
CLN: updated structure of code.

Changed directory name from Python to smolyak

Changed directory name from Julia to src