Major documentation additions to explain patterns and usage