add some notes based on https://github.com/Janzert/AEI/issues/4