dont repeat yourself
doc: do not import python source code to make building the documentation work stand alone
doc: removed doctest
docu terminology: cleanup, don't duplicate example further below, added "merge", reference-to-one/many entries.
doc terminology: cleanup, don't repeat examples further below; added "merge", reference-to-one/many entry