copy Waldo's explanation of some terminology from issue #494 into the docs

Thanks for the response on https://github.com/statedecoded/statedecoded/issues/494. I thought it would be useful for others to read here.