Update documentation for new users coming from Homebrew revision 2

[seivan]

Reflect changes introduced in Homebrew/homebrew-core#73173

Summary

Existing solutions like source "$(brew --prefix asdf)/asdf.sh" will still work, so there is no need to migrate.
There will be one level of indirection as that will source the real path /usr/local/opt/asdf/libexec/asdf.sh

The documentation reflects the changes for new users and new paths for various shell scripts.

• How to add shims to $PATH
• How to source "$(brew --prefix asdf)/libexec/lib/asdf.sh" to get $ asdf shell <package> <version>

[jthegedus]

How to add shims to $PATH

Is this a requirement for existing users too?

[seivan]

How to add shims to $PATH

Is this a requirement for existing users too?

Nope.

[jthegedus]

I appreciate your work on this @seivan , sorry for the delay with reviewing all this.

[seivan]

@jthegedus Btw, the Fish stuff needs an extra set of eyes, and I haven't tested Bash.
However Zsh is pretty solid.

[seivan]

I appreciate your work on this @seivan , sorry for the delay with reviewing all this.

Yeah no worries, asdf has potential, but it's very messy if I can be blunt. I got a list of things I'd want to discuss if you'd be open to it.

[jthegedus]

I got a list of things I'd want to discuss if you'd be open to it.

For longer form discussions and feedback please use GitHub Discussions and tag me. Keep in mind that the core asdf team probably also want the changes you're thinking of, but just haven't had the time or capcity to get to it.

[jthegedus]

the Fish stuff needs an extra set of eyes, and I haven't tested Bash

If you can corral some Homebrew users to test that would be good.

[seivan]

I'm setting up images to test, so far for setting up $PATH changes in https://rootnroll.com/d/fish-shell/ seems fine.

• Set up path
• Test completion
• Test libexec/lib/asdf.fish