doc improvements, fixed images, texts, etc
ignore tmp and out