updated some method stubs with more discussion