User:SwifT/Complete Handbook/So far so good

Used symbols and colors
Okay, we are now at the end of this first part. As you might have seen, the previous sections suddenly started using some Linux-specific commands. I will quickly explain how this handbook uses those Code Listings and other syntax.

Code listings
A Code Listing can be a command that needs to be executed. When this is the case, the command is prepended with a symbol that refers to the prompt.

A prompt is a short string given by the system to the user, telling that the user can give a command. By default, the prompt for a regular user would look like so:

When you are the root user, the prompt will look like so:

As you can see, it differs with the ending character: regular users have a prompt that ends at $, but the root user has an ending character of #. For this reason, we will use this single character throughout the rest of the document to refer to the prompt. When the character is a $ you can (should) execute the command as a regular user. When the character is a # you can (should) execute the command as the root user.

For instance, the ls command (which lists the content of the current working directory) can very well be ran as a regular user, but to install a package (like bzip2) you need to be root:

As you can see, the command itself is highlighted. When there is output from the command to the screen that you do not need to type, it will be in plain text. When we add some comments, you will notice that it has a different layout. For instance, to change your password:

We will also use Code Listings to show the contents of a file.

Warnings
When the information in this handbook is incorrect due to a bug or a temporary issue, I use a warning to inform you about this temporary setback. I prefer to do it this way than to fix the content itself because I feel that documentation should not be used to fix bugs (or provide workarounds).

An example warning would look like so:

Important
When we want to stress out something important, we will normally put this in the paragraphs using emphasised text or bold text. However, when it is quite urgent and would require a larger rewrite, we will temporarily use an importancy-box like so:

Installing Gentoo
In the next part, we will give you lots and lots of Linux technical information to allow you to install Gentoo Linux on your system. Unlike with the Gentoo Handbook we will try to be more verbose (yes, that's possible :) but less step-by-step.

Why? Because you should be able to install Gentoo the way you like it without the need to take a look at the step by step descriptions. Not that the Gentoo Handbook is written badly (hey, I wrote the most of it :p) but just... differently :)