improved developer notes