added comments to example markup