adding some comments in my (stephans) methods