operators, not Boolean operators

one more change in the swap_descriptions file to be made later
hide example

probably deprecate
updates per sh/upgrade-errata branch
edits
touch up new upgrade notes