more complete docs, showing before and after