comments for almost all important files

This can be merged, if the text seems fine to you