See https://debarshiray.wordpress.com/2021/11/10/toolbox-is-now-toolbx/
Language here attempts to mirror CoreOS docs:
* "A toolbox" is unchanged
* References to the `toolbox` binary are unchanged (or clarified)
* "Toolbox container" is changed to "Toolbx container"
* The name of the project itself is changed
I feel like including that right after "Containers are a safe space to experiment" is a good way to avoid users thinking that a toolbox container can be used to do and test software they don't trust.
Align the style for the entire documentation to prefer one sentence per
line. This has the following advantages:
- Asciidoc properly combines lines of text into a single paragraph
- This keeps the Git diff readable and minimal while keeping line
lengths reasonable
- Some Asciidoc functionnality does not interact well with hard wrapped
lines
In my previous commit I made an oversight and one of the blocks was not
properly styled.
Also, until now the "Commands and usage" section used question/answers
format for command description. I expanded the description in the
previous commit and that caused to show the shortcomming of the format.
Only the first paragraph is considered the answer. This causes
misallignment of the text. With this the questions are turned into 3rd
level titles. This also allows to link to the command description.
Buildah is no longer used in Toolbox to (re)create images.
`toolbox run` is also a command of Toolbox that needs to be mentioned.
Some users that use `zsh` with `powerline` or something similar sometimes get confused by the lack of the diamond symbol that signalizes being in a toolbox. Before the profile file is updated, it should be documented.
The 'How it works' section did not mention `flatpak-spawn` which is used to execute commands on the host.
This is a rewrite of the toolbox docs, but I've tried to incorporate points and material from the original.
Main goals: add more detail and refinement. Cover all the essential information that a new user might need, particularly one who isn't very familiar with the Linux command line.
