documentation
documentation copied to clipboard
simplify `updating.md`
closes #1723