* Add links to github issues in the README and clarify run instructions * Added a new doc in the core package with architecture notes.