Better docs? Better examples? A tutorial?

[0foo]

I'm trying to use and it looks great but there's only one example and the docs are unclear.
And obviously due to the name it's impossible to google.

How do I add CSS classes?
What exactly is a widget?

etc. etc.

[balupton]

Not exactly sure a pull request is needed, just a description of what widgets are and how they are different to fields and how they work with fields would be useful.

As currently, there seems to be widgets for each field, and then some more. Should we use widgets or should we use fields?

[ljharb]

Fields determine behavior; widgets combine with a field to determine the HTML that results. You should use whichever you need :-)