doc: update canvas before/after doc according to the PR. Closes #1019
merge