docs update with reasons / bugfix