doc: clarify the doc
Merge branch '0828-doc' of github.com:vicb/guinness into vicb-0828-doc

Conflicts:
	lib/src/common/expect.dart
Merge branch 'vicb-0828-doc'