this looks nice! can you please add a method comment explaining the 3 ways to use the method?