Format for procedures

[Stoos, Ralph]

All,

 

I would like to suggest a change to the format of procedural
instructions.  I realize that this change will make for more changes,
but it benefits the user in two ways.  One, it allows the Table of
Contents to have a high level of granularity for faster access.  Two, it
gives the uses "checkpoints" to know where they are in the process.

 

I took this paragraph below from the Desktop Guide as an example.  By
all means tell me I am crazy, full of it, or just wrong.  I have used
this format with great success in a number of publications I have
authored that are procedural.

 

Further, I do not wish to insult anyone's work.  It occurs to me that
these documents are put together by a small group and done under great
time pressure.  This is not a rip, merely a suggestion for discussion.
I have guessed at a couple things because I run KDE and use K3B most of
the time.

 

This note will no doubt come through with a lot of the formatting
stripped off.  I bold proper names and button names to have them stand
out.  I also number steps so users can track where they are.  Since I
have broken out audio CD vs. Data CD procedures, they should appear as
separate entries in the TOC and make a specific want by the reader
easier to find.

 

Regards,

 

Ralph

 

3. Burning CDs

When you put a blank CD in the drive Ubuntu will ask if you want to burn
an audio or data CD.

Clicking on Burn Audio CD will launch Serpentine . To add music to your
audio CD, either drag

music from your File Browser or use the Add button. You will also need
to select the size of your CD

(21, 74, 80 or 90 minutes). Serpentine will warn you if you exceed the
set limit.

To make a photo or data CD, click Burn Data CD. Ubuntu will open a
CD/DVD Creator window.

The CD Creator is built into the File Browser, and it allows you to add
any file or folder you have

permission to access. When you are ready to burn the CD, click Write to
Disc. Ubuntu will then

prompt you to select the drive containing the blank CD, and give you the
opportunity to name the CD

and select the write speed. Finally, click Write to create the new photo
or data CD.

 

#########  My attempt below using the data above

3. Burning CDs

 

When a blank CD is inserted in a CD or DVD burner drive, a dialog will
open to ask the user to choose the type of CD or DVD they wish to write.

 

To burn an audio CD:

 

1.	Click the  Burn Audio CD entry.  The Serpetine application will
be started.
2.	You may drag and drop music files from the File Manager or
selected the desired files and click the Add button.
3.	You will be prompted to select the size of the CD media (21, 74,
80, 90 minutes).
4.	If your selections exceed the size of the chosen media, you will
be warned.
5.	Click the <Write to Disc / Burn?> button to start the process.
6.	When the write operation is finished, eject the CD.

 

To burn a Photo or Data CD:

 

1.	Click Burn Data CD.  The CD/DVD Creator included in the File
Browser application will be started.
2.	You may add files from the File Manager as long as you have
permissions to the files or directories you choose.
3.	Click the Write to Disc button.
4.	You will be prompted to select the drive that contains CD/DVD
media.
5.	You will be prompted to choose a volume name of the writable
media.
6.	You will be prompted to select the write speed for the media.
7.	Click the Write button to start the process.
8.	When the write operation is finished, eject the CD.

 

 

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20061114/80465388/attachment.html>