Good question - I think in the near future, this solution will be better referenced from the new Snapcraft build, debug and publishing docs roadmap, which we are working on and will complete soon. There’s troubleshooting for each phase and this will be a common question.
But it’s probably also worth mentioning in some of our environment variable documentation, where you might expect references to a user’s $HOME, for example.
I’ll make a note to do both of the above.