Added return type for run_sampler

This is mildly annoying for me usually, because it prevents me from using code completion

changed milestone to %1.0.2

added Documentation label

@moritz.huebner out of curiosity why did you add the bilby import?

approved this merge request

This is helpful for code completion software like I use in PyCharm. I could also do import bilby.core.result.Result explicitely. Software like PyCharm will figure out that this is associated with the respective class and provide sensible code completion options and will highlight, e.g., if you try to call a method that doesn't exist and stuff like this.

approved this merge request

merged

mentioned in commit 82872fe5