added missing convenience methods
added notes on convenience methods