Documentation needs to be improved

[serazing]

There is still a lot of work to do on the documentation.

[dhruvbalwada]

It would be great if some examples could be documented. I just started working with with xscale and would love to get involved in using and maybe even adding some features to it eventually.