using the new decompose method in JsonHelper
miscellaneous updates and integrated documentation
wordsmithing