the project seems cryptic

[amir-arad]

• readme in the repo root (what this is, what it solves, what is found where, some high level design, how to use)
• readme in each example (what this example shows, how to use it)
• example for testing an application written in the engine