issue #112 part 1 notes