Improve intro and move API docs to examples (temporary until @zackbloom makes a more generic folder structure work)