tweak docs & examples