changelog + improved docs