some tweaks + doc