Proper Documentations Needed
Editing/modifying drupal core modules is not advisable. Having the core modules modified makes it harder to migrate to newer versions of drupal.
But certain unavoidable circumstances developers to modify the core modules. When these circumstances come, it would be very helpful to have proper documentation. It will keep track of the changes made.