Skip to content

Add new asdf troubleshooting section

Evan Read requested to merge eread/add-asdf-troubleshooting-and-increase-visibility into main

What does this Merge Request do and why?

We seem to have an increase in folks running into incomplete asdf installation problems. The root cause seems to be that GDK tooling can't handle their being no shell configuration when it bootstraps.

That is fixable, but in the meantime, we can document a workaround. This can be expanded with extra steps as necessary. This is also a good opportunity to increase the visibility of the troubleshooting documentation in general.

CC @smcgivern @nadia_sotnikova

Merge Request checklist

  • This change is backward compatible. If not, please include steps to communicate to our users.
  • Tests added for new functionality. If not, please raise Issue to follow-up.
  • Documentation added/updated, if needed.
  • gdk doctor test added, if needed.
  • Add the ~highlight label if this MR should be included in the CHANGELOG.md.

Merge request reports