Improve doc comments in several classes#1

tmotyl wants to merge 2 commits intoShoplo:masterShoplo/store-client:masterfrom

macopedia:improvementsmacopedia/store-client:improvementsCopy head branch name to clipboard