add docstrings and tests to FutureCollection
add Class#method_documentation: and use it where it makes sense
small code cleanup
Block#call_with_errors_logged - log to *stderr* by default
shorter sleep in test
more fdoc refactoring and add progress indicator
refactor fdoc JSON#initialize: