make some minor changes and add notes