The message when running juju 2 for the first time gives help about how to get juju-1 back. However, this information is very confusing as written, and for trusty users (who are the most likely to see it / have it affect them) it is wrong.
"Welcome to Juju 2.0.0. If you meant to use Juju 1.x you can continue using it
with the command juju-1 e.g. 'juju-1 switch'.
See https://jujucharms.com/docs/stable/introducing-2 for more details."
Saying juju-1 switch is confusing. Users (and me!) think it's a command to run (see bug 1633542). What is really being conveyed is that there is a link to the juju-1 binary by running juju-1. For trusty, this is not true. We should tweak the message to be clear, and drop the confusing juju-1 switch command which is implying something akin to 'run this to get juju 1.x back', rather than the intended 'use juju-1 to get /usr/bin/juju-1 which is the juju-1 binary'. For trusty users, update-alternatives should be used. On xenial, juju-1-default package install can be used. You can also call it expliclity on xenial/yakkety as noted. It may be best to drop this confusing verbiage altogether and point at a clear and concise docs page which can detail these differences.
Doc issue to create a manual page: https:/ /github. com/juju/ docs/issues/ 1487
Once this page exists, we should link to it in the welcome message. Meanwhile, I'll propose prose.