Shell prompt guidelines

The following guidelines cover how to write Shell prompts on MDN pages.

Shell prompts in brief

A shell is a program that waits for you to type in a command and then press the return key. To indicate which commands you should type, MDN documentation lists them in a code block, similar to code examples. Such a block looks like this:

# This may take a while...
hg clone https://hg.mozilla.org/mozilla-central/ firefox
cd firefox

Guidelines

There are a some guidelines to follow when writing a shell code block:

  • Do not include a "$" or ">" at the beginning of a shell instruction. It confuses more than it helps and it is not useful when copying the instructions.
  • Comments start with "#".
  • Choose the "Bash" syntax highlighter.

Good shell prompt examples on MDN

Our Django server-side development docs show good practice presentation of shell prompt commands, etc. on MDN. See Setting up a Django development environment for example.