31
Writing Web Tutorials Writing Web Tutorials Martin Tessmer Martin Tessmer Center for Center for Innovations in Innovations in Training Technology Training Technology UCDHSC UCDHSC http://thunder1.cudenver.edu/ http://thunder1.cudenver.edu/ citt citt

Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

Embed Size (px)

Citation preview

Page 1: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

Writing Web TutorialsWriting Web Tutorials

Martin TessmerMartin Tessmer

Center for Innovations Center for Innovations in Training in Training TechnologyTechnology

UCDHSCUCDHSChttp://thunder1.cudenver.edu/citthttp://thunder1.cudenver.edu/citt

Page 2: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

What CITT Does What CITT Does (With ULDI)(With ULDI)

Develops online courses for CU. Develops online courses for CU. 29,000 trainees, 65,000 usages.29,000 trainees, 65,000 usages. Up to 14,000 trainees per Up to 14,000 trainees per

course.course. 16,700 course certificates.16,700 course certificates. 95% or higher approval rating.95% or higher approval rating.

Page 3: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

0

5000

10000

15000

20000

25000

30000

2003-04 2004-05 2005-06

Acceses

Online Course AccessesOnline Course Accesses

Page 4: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC
Page 5: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC
Page 6: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC
Page 7: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC
Page 8: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

What We Start WithWhat We Start With

Page 9: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

Where We End UPWhere We End UP

Page 10: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

Reading Web “Pages”Reading Web “Pages”

Screens are hard on the eyes Screens are hard on the eyes

Screens on hard on the brainScreens on hard on the brain

People scan, not readPeople scan, not read

““Pages” a serious misnomerPages” a serious misnomer

Page 11: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

Course Quality FactorsCourse Quality Factors

Succinct and clear text.Succinct and clear text.

Frequent interactions.Frequent interactions.

Objectives, content, and test coordination.Objectives, content, and test coordination.

Page 12: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

Let’s Look at CU’s Let’s Look at CU’s IT Security CourseIT Security Course

http://www.cittdesign.com/it_security_demo/index.htm

This link is active until June 1, 2007.This link is active until June 1, 2007.

Page 13: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

1. Write Screens < 180 Words1. Write Screens < 180 Words

Page 14: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

How to Reduce TextHow to Reduce TextBy “Finding” ExcessBy “Finding” Excess

“Will be able to” is “can” “Due to the fact that” is “because”

“That,” “which,” and “who” clauses can be adjectives.

Cure “Conjunctivitis”: two or more conjunctions in a sentence.

Lists of more than three tax the brain.

Page 15: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

“The applicant pool is the most useful tool to ensure that you are recruiting highly qualified candidates who can further the University’s education mission and goals.  The applicant pool is also the most useful tool to ensure that you are recruiting diverse candidates, including minority and female candidates, who can foster the University’s commitment to diversity.”56 Words.

Practice: Reduce Text

Page 16: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

The Pool is the Tool

“The applicant pool is the best tool to recruit highly qualified and diverse candidates, fostering the University’s commitment to diversity.” 20 Words.

One AnswerOne Answer

Page 17: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

2. Use Thematic Headings2. Use Thematic Headings

Page 18: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

Script With Good HeadingsScript With Good Headings

Page 19: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

Script With Better HeadingsScript With Better Headings

Page 20: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

Practice: Make a HeadingPractice: Make a Heading

ItÕs important that you actively manage your employeeÕs performance by 1) creating a performance plan, 2) monitoring employeesÕ progress in

attaining them, 3) coaching employees to better

performance, and 4) evaluating their end of year

attainment.

This is all part of the Performance Management approach utilized at CU.

Page 21: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

Some PossibilitiesSome Possibilities

Performance Management’s four-step process.

Performance Management: plan, Performance Management: plan, monitor, coach, and evaluate.monitor, coach, and evaluate.

Performance Management: active Performance Management: active supervision. supervision.

Page 22: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

3. Layer the Text3. Layer the Text

Page 23: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

Two and Three DimensionsTwo and Three Dimensions

Page 24: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

Practice: Create LayersPractice: Create LayersWhether you are filling a vacant position or creating a new one, use a Position

Description Questionnaire (PDQ) to detail your position’s duties and responsibilities. The PDQ is defined as “an important human resource management document. It describes the duties and responsibilities of the position; establishes the essential elements of the position for Americans with Disabilities Act purposes; is the primary

document for determining job classification; and, sets the pay range for theposition.”.” The PDQ is the official description of a position, used to determine the proper occupational field and job class. A job class is a category used to describe positions whose essential character, nature of work, and job responsibilities warrants the same pay grade, title, and qualifications. You can find job class descriptions at www.

colorado.gov/dpa/dhr/comp/docs/cds/cdhomepage.htm One way to quickly and accurately complete a PDQ is to ask Human Resources if there

are existing PDQs for your position, written by other departments. You can revise these and submit them for your own position,

Page 25: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

One AnswerOne Answer

Do and review the PDQ

Whether you are filling a vacant position or creating a new one, use a Position Description Questionnaire (PDQ) to detail your position’s duties and responsibilities.

The PDQ is the official description of a position, used to determine the proper occupational field and job class.

Steal this job!. To quickly and accurately complete a PDQ, ask Human Resources if there are existing PDQs for your position. Revise one and submit it for your new opening.

Page 26: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

4.. Frequent Interactions4.. Frequent Interactions

Page 27: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

Scenarios for Problem SolvingScenarios for Problem Solving

Page 28: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

Practice: Create Practice: Create ScenariosScenarios

Providers must give patients a copy of their file, if the patient requests it.

0 True o False

Patients may see their psychiatric treatment information without permission from the treating physician.

0 True o False

Page 29: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

Sample Answer

Page 30: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

Three Useful Web Three Useful Web Writing ResourcesWriting Resources

Webwritingthatworks.com

Hot Text. Jonathan and Lisa Price

Eats, shoots, and leaves. Lynne Truss

Page 31: Writing Web Tutorials Martin Tessmer Center for Innovations in Training Technology UCDHSC

ENDENDWriting Web TutorialsWriting Web Tutorials

Martin TessmerMartin Tessmer

Center for Center for Innovations in Innovations in Teaching Teaching TechnologyTechnology UCDHSC UCDHSC