doc
doc
update README
more on allocation
doc for the observer
naive scheduler
re-organise code