updated comments for abstractions