add some notes on the implementation of the compilation database