add documentation for fallible

[samccann]

Community can't find details on what fallible is - https://pypi.org/project/fallible/

So add documentation that describes:

• what is fallible?
• why would someone use it?
• how to use it (2-3 common use cases)