Documentation of bzrlib is sparse

[Alexander Gabriel]

a few examples:
- sparse information on key aspects:
    tutorials/howtos/examples on basic use cases (creating a standalone branch for example)

- no information on the format of paramters (dict, set, plain)
    example: from_paths in bzrlib.workingtree.WorkingTree.move() is this a set?

- no information on details of parameters
    example: The paths in bzrlib.workingtree.WorkingTree.rename_one() are relative to what?

- no information on the expected classes/subclasses
    example: what is "target" (Branch, URL,?) in bzrlib.branch.Branch.push()?

bzrlib is huge, knowing what parts you need and how to combine them is far from obvious.

This makes working with bzrlib a pain while working with bzr was a breeze.