Example of stacked environments

[kousu]

I found it hard to understand how to work with stacked environments. The algorithm explanation is very nice but it clarifies things a lot for me to see why and how I would be interested in this feature.

I think/suppose for most users, the key point should be that you want to install dev tools in @v#.#, like suggested for Revise, and not think about stacked environments otherwise. But for people who want to go further, this will help.

[github-actions]

Hello! I am a bot.

Thank you for your pull request!

I have assigned @LilithHafner to this pull request.

@LilithHafner can either choose to review this pull request themselves, or they can choose to find someone else to review this pull request.

[LilithHafner]

Thanks for offering this idea for the manual!

The bulk of this seems like a tutorial describing a fairly involved workflow. This sort of content is rarely appropriate for the manual, and doesn't concisely exemplify the section that it's an example in.

Maybe an example that uses only the global environment and a project environment would be better. I would also avoid introducing startup.jl files into this and copying from the downloads folder.

[LilithHafner]

This startup file will significantly increase julia startup latency.

[kousu]

Thank you for the review.

I wanted to contribute this to contribute the push!(LOAD_PATH, expanduser("~/.julia/environments/sci-tools")) line. As I understand it, stacking environments is potentially very flexible and useful when used with shared environments, but without an example showing how to do it the only stack people ever interact with is the [project, stdenv, stdlib] stack. I found push!(LOAD_PATH,...) counterintuitive, is all, and I guessed I wouldn't be the only one, because it looks different than Pkg.activate().

If I could just get that one line in somewhere I would be happy. If not in this section is there a better place you could recommend for it?

[LilithHafner]

That sounds like a fine inclusion as an example. Though we should probably use "@x" instead of the IIUC equivalent expanduser("~/.julia/environments/x"))

---

As an aside, I personally have both

# https://github.com/JuliaLang/julia/issues/46231
isinteractive() && insert!(LOAD_PATH, 1, mktempdir())

and

isinteractive() && push!(LOAD_PATH, "@Plots")

In my startup.jl file.