feat: rewrite the readme for consistency, and update all API references

[Bubblyworld]

This is still a work-in-progress, just posting this to track the progress.

Resolves https://github.com/jspm/generator/issues/232.

[Bubblyworld]