People using 1.0 should read the 1.0 docs (when fabien fixed the version switcher...) and they will see the workaround.