proper formatting, completed documentation for all 3 listed scenarios