Silverblue is using fedora-toolbox to provide access to CLI tools and a familiar development environment. Since the toolbox will be a new concept to most users, we'll need to provide some assistance to help people get started.

A simple approach might be to print a helpful welcome message when someone uses the Terminal for the first time, with a link to some documentation.

I think the documentation we're looking for is a basic introduction to toolboxes - what they are, how they work, what they're good for - delivered as part of a short overview. Then a succinct how to.

A few questions to consider:

• If we only show the message the first time the Terminal is launched, how does someone find the documentation later?
• What's the best way to make the documentation available? It would be good to have it both locally and online. It would also be good to be able to easily update it, since it's likely to evolve fairly quickly in the beginning.
• Above I've suggested that we should print the welcome message in the prompt itself, but another option might be to show the information through the Terminal, using GTK.
• It's worth considering if there are opportunities to link to other documentation around containers and container tooling.