Course Information  [  Logistics  |  Course Links  |  Calendar of Classes  |  Coursework Calendar  ]



   (Your comments will be sent anonymously to the instructors)

Logistics

Lectures: Su,Tu   16:30 - 17:50 (room 2035)

Class Webpage:   http://qatar.cmu.edu/cs/15221

Instructors: Andreas Karatsolis
Office hours:  Th 9-10:00 and by appointment
Office:  CMU-Q 1154
Email:  karatsolis@cmu.edu
Iliano Cervesato
Office hours:  by appointment (check schedule)
Office:  CMU-Q 1008
Email:  iliano@cmu.edu
TA: Hamsa Al-Masri
Office hours:  TBA
Email:  hamsa.m91@gmail.com

Course Links

Calendar of Classes

Click on a class day to go to that particular lecture or recitation. Due dates for homeworks are set in bold. The due date of the next homework blinks.

September 2011
UMTWRFS
    123
45678910
11121314151617
18192021222324
252627282930 
       
October 2011
UMTWRFS
      1
2345678
9101112131415
16171819202122
23242526272829
3031     
November 2011
UMTWRFS
  12345
6789101112
13141516171819
20212223242526
27282930   
       
December 2011
UMTWRFS
    123
45678910
11121314151617
18192021222324
25262728293031
       

About this course  [  Description  |  Feedback  |  Readings  |  Etiquette  |  Grading  |  Assessment  ]

Description

The course is designed for Computer Science majors (sophomores or higher) to improve their applied communication skills (written, visual and oral). It aims to help students learn how to read and analyze technical CS texts as well as design and present technical Computer-Science related documents for professional or lay audiences. Assignments include job application materials, instructions, genre analyses, and proposals, and may incorporate recent Computer Science research at Carnegie Mellon, projects in related technical courses, and/or professional client-based projects. Working through textbook explanations and examples, analysis of sample texts, and the examination of common forms of workplace and academic communication, students will be able to focus on producing effective technical communication artifacts for their discipline.

Readings

Other Useful References

Several handouts will be available on the course Blackboard site.

Course Etiquette

Class conduct

You should arrive in class on time (4:30pm), with mobile phones turned off, and ready to discuss, present, or otherwise participate. Additionally, as this course focuses on professional communication, all course-related correspondence (email, discussion board postings, notes to professors) should use language that demonstrates your professionalism. In other words, emails should not use slang or have misspelled words. Finally, since we are meeting in a computer cluster, you are expected to work with the classroom computers (not laptops) whenever you are asked to.

Attendance

There is no component of your final grade assigned to attendance. This simply means that your attendance will be required at all times, especially since this class is primarily conducted as a seminar/workshop. You are allowed up to three unexcused absences, but this does not exempt you from turning in work on due dates. We would therefore expect you to contact us if you know you are going to be absent. In the case of emergencies or sudden illness it is your responsibility to provide appropriate and prompt documentation upon your return to class. Anything more than three absences will result in a lowering of your grade by one-third letter grade for each absence over the limit (an A becomes an A- in the fourth absence, B+ in the fifth etc).

Conferences: Three times in the semester we will not hold our scheduled class, but arrange for a specific time to meet with your instructor(s). These are required meetings and if you fail to attend, you will receive an absence.

Feedback

It is our goal to make this course successful, stimulating and enjoyable. If at any time you feel that the course is not meeting your expectations or you want to provide feedback on how the course is progressing for you, please contact me. If you would like to provide anonymous comments, please use the feedback form on the course home page or slide a note under our doors.

Grading

This is a 9 unit course.

Tasks and Percentages

Coursework Details

Projects (85% of the final grade)

In this course there are four distinct projects, each designed to help you develop a combination of skills essential in Professional and Technical Communication for Computer Scientists. For all projects you will be required to make some decisions about the area you will be working on and the content you will be using. The final grade for each project will be calculated based on your work on all the deliverables, including drafts, presentations, peer reviews and reflections.

Here is a brief description of the assignments:

Resume and Cover Letter (15% of final grade)
For this assignment, you will locate and apply for a job opening or internship. If you are applying to graduate school, you can use this assignment to apply as well. The position/graduate program you apply for must be real and one that you are qualified for. It should be related to your career goals and can be a full-time position or an internship. Once you locate a position, you will analyze the job ad or information and do background research on the employer, school and field to plan a strategy for presenting your relevant experience and qualifications. We therefore take an approach to creating cover letters and résumés that does not assume all applications packages work equally well for all audiences; applications should be carefully crafted, reader-centered documents that take into consideration the needs and wants of the audience. In the process of completing this assignment, you will have the opportunity to produce a professional CV which you will also upload on the website of the Computer Science Qatar department.
Genre Analysis (20% of final grade)
This assignment asks you to analyze in depth a document or series of documents within your discipline (Computer Science), but beyond the scientific or professional genres that we have discussed, ideally one you think is essential for your career. Your instructors will provide you with a list of possible genres to analyze, but then it is up to you to decide how you will collect information about them (interviews, library research, linguistic or rhetorical analysis). Your overall goal is to show that you understand where this document fits in relation to other documents, people and the work it accomplishes. Your deliverables include a poster presentation, where you will have the opportunity in 5-7 minutes to explain the findings of your research to your fellow students.
Software User Guide (25% of final grade)
In this assignment you will be asked to produce an illustrated set of instructions (in an appropriate medium) to guide a specific audience trying to use a software application or device. This assignment will require you to become acquainted with the software or device, conduct an audience and context analysis, translate that analysis into a document plan, write and revise the user guide based on user and instructor feedback.
Proposal (25% of final grade)
In the final assignment you have to influence your audience's thinking and acting, as you will be requesting their support or endorsement for a proposed project which your instructors will identify. You will have to: 1) persuade your audience that a serious problem or opportunity exists; 2) propose a detailed, practical solution that the audience will be able and willing to implement with your support. This project includes an oral presentation, a 60 second elevator pitch.

Weekly Component Skills Homework (15% of final grade)

In the same way you go to the gym for an hour/week to keep fit, you will have to do some practice with some of the technical aspects of professional writing. These might include:

Putting in a good faith effort and completing 15 of these exercises will give you the full 15 points.

Evaluation Criteria

For each project you will receive a rubric to guide you and help you understand the evaluation criteria. Rubrics will follow a 5-point scale, roughly corresponding to the following:

Note that this is not a traditional grading scale; that is, 5 does not translate into an A, 4 into a B, and so on. In fact, if you have 4's on every assignment throughout the term, you would have a final grade in the 90's range.

Final course grades will be assigned using the following scale:

A >= 90 B=80-89 C=70-79 D=60-69 R < 60

Late Work

All work must be submitted in class on the due date. You can receive an extension only if you meet two conditions:

  1. Contact me before the date on which the assignment is due to explain why you need an extension, and
  2. Submit the assignment within one week after the scheduled due date.
Using these procedures, you may submit a late assignment. 5 pts (on a 100 pt scale) will be deducted for each day the assignment is late (e.g., If you are two days late, 10 points on a 100 point scale will be deducted). This policy does not apply to the final homework, which must be submitted on the due date (in order for me to get final grades in on time).

Acceptance of late work that does not meet these conditions is at the discretion of the instructor.

Academic Resource Center Assistance

We strongly encourage you to take advantage of the free services the ARC (Room 1048) offers to students. You can visit the Center at any stage of your writing process and receive feedback on anything from grammatical issues to organization and development of ideas.

Academic Integrity

The CMU Handbook defines various forms of academic dishonesty and procedures for responding to them. You should familiarize yourselves with this portion of the Handbook (p. 194) and note that penalties for any form of cheating can be quite severe. Since this is a writing course that requires a lot of research, you have to be especially careful to avoid plagiarism, which can be defined as:

The penalty for plagiarism is the same as cheating, which is automatic failure for the course.

Assessment

University Aims

Course Objectives

The assignments and lectures in this course are intended to improve your ability to:

  1. Communicate with a variety of real audiences that will actually depend upon and use what you have created.
  2. Achieve a variety of rhetorical purposes, such as informing and persuading.
  3. Develop a meta-awareness of reading processes and purposes, which will help you become more effective readers and writers of material in Computer Science and related fields.
  4. Analyze the generic structure and social use of documents in Computer Science.
  5. Incorporate visuals (graphs, visual images, page/screen design) into your writing and speaking.
  6. Make effective oral presentations depending on situation and audience.
  7. Assess your own work and the work of classmates.

Schedule of Classes

At a glance ...

September 2011
UMTWRFS
    123
45678910
11121314151617
18192021222324
252627282930 
       
October 2011
UMTWRFS
      1
2345678
9101112131415
16171819202122
23242526272829
3031     
November 2011
UMTWRFS
  12345
6789101112
13141516171819
20212223242526
27282930   
       
December 2011
UMTWRFS
    123
45678910
11121314151617
18192021222324
25262728293031
       

Sun 4 Sep
Lecture 1
Introduction to the course — The Basics of Technical Communication
  • Component skills pre-assessment
Editing for correctness
Tue 6 Sep
Lecture 2
The Rethorical Approach
  • J. Reddish: "Understanding Readers"

Sun 11 Sep
Lecture 3
Scientific Writing process and Principles — Style (introduction to technical editing)
  • Hofmann Chapters 2-6
Parallelism
Tue 13 Sep
Lecture 4
Writing Job-application materials (project 1)
  • Hoffman Chapter 29
  • Reading pre-assessment

Sun 18 Sep
Lecture 5
Document and Visual Design
  • Hoffman Chapter 9
  • OLI module
Alignment and contrast
Tue 20 Sep
Lecture 6
Peer review workshop & intro to Genres (project 2)
  • CV and cover letter draft

Sun 25 Sep
Lecture 7
Reading a CS research paper
  • Hoffman Chapters 10-13
Data commentary moves
Tue 27 Sep
Lecture 8
Analyzing genres — Abstracts
    • Hoffman Chapter 14
    • Genre analysis readings (Bhatia et al)

Sun 2 Oct
Lecture 9
Conducting field research
  • Odell and Katz Chapter 10
  • CV and cover letter final
Conciseness
Tue 4 Oct
Lecture 10
Posters
  • Hoffman Chapter 27

Sun 9 Oct
Lecture 11
No class — individual conferences on posters
  • Poster draft
Gapping (captions and headings)
Tue 11 Oct
Lecture 12
Introduction to project 3

Sun 16 Oct
Lecture 13
Poster Session I
Procedural-functional elaboration
Tue 18 Oct
Lecture 14
Poster Session II

Sun 23 Oct
Lecture 15
Technical documentation (project 3)
  • Barker Chapters 1
Coherence (global and local)
Tue 25 Oct
Lecture 16
Collaborative work
  • Markel Chapter 4

Sun 30 Oct
Lecture 17
Analyzing Audiences
  • Barker Chapters 2
Given-new contract
Tue 1 Nov
Lecture 18
Tutorials/Procedures/Reference
  • Barker Chapters 12-14
  • User guide audience analysis

Sun 6 Nov
No class (Eid Al-Adha)
Writing for non-experts
Tue 8 Nov

Sun 13 Nov
Lecture 19
Writing Proposals (project 4)
  • Hoffman Chapters 19-20
Forecasting and summarizing (meta-discourse)
Tue 15 Nov
Lecture 20
Designing and Using Graphics
  • Barker Chapter 11

Sun 20 Nov
Lecture 21
Peer review workshop
  • User guide draft
Nominalization
Tue 22 Nov
Lecture 22
Proposals II
  • Markel Chapters 21-26

Sun 27 Nov
Lecture 23
No class — group conferences on proposals
Documentation
Tue 29 Nov
Lecture 24
Evaluating and Testing
  • Barker Chapter 6

Sun 4 Dec
Lecture 25
Persuasive oral communication
  • Markel Chapter 6
Sentence and paragraph length
Tue 6 Dec
Lecture 26
Peer review workshop
  • Proposal draft

Sun 11 Dec
Lecture 27
Oral communication workshop (elevator pitch)
Sentence shape and rhythm
Tue 13 Dec
Lecture 28
Course reflections and debriefing
  • Final user guide
Thu 15 Dec
Final proposal due


© 2011 Iliano Cervesato iliano@cmu.edu