added more documentation for patching (more transparency)