paperlined.org
apps > FreeGeek > TODO
document updated 13 years ago, on Sep 11, 2010
I need to revamp the sound/video card test station's little writeup that accompanies it.

The test station is more challenging than most, because it's the one place that requires use of the
command line.  However, several volunteers have nonetheless shown real interest in learning how to
use it.

So, it sometimes ends up being used as an "intro to using the command line" class.



As such, I need to improve the sheet/handout at that station.  Specific changes I need to make:

==== general layout ====

    - use two VERY clearly distinct fonts:
            - one for prose
            - one for commands that are meant to be typed in

    - ALWAYS explicitely list spaces using Unicode character 2423  "OPEN BOX",
                since users are sometimes unclear about whether there's a space after "cd", and
                sometimes in other places  (often in the negative case (ie. they think an extra
                space should go where it shouldn't), so I need to make 100% sure it's used in EVERY
                place a space would be)

    - always explicitely list "enter" using Unicode character 21B5  "DOWNWARDS ARROW WITH CORNER LEFTWARDS"


==== sidebars / other sections ====

    - add a "legend" sidebox that indicates what those two symbols mean (Unicode 2423 and 21B5)

    - add a "glossary" sidebox that mentions:

            - "cd" stands for "change directory"
            - "ls" stands for "list" files

    - add a "tips" section, and note that you can use the arrow keys to go through history, so you
      don't have to retype anything