[#1231] Make a correction to the docs

Fixes #1231
Merge branch '1231-best-practices-for-writing-extensions-mistake'