Technical Writing for Computer Science Part 1: Content and Organization Research Careers Lecture Series July 13, 2009 Michael J. Lewis, Director Department.

Slides:



Advertisements
Similar presentations
Critical Reading Strategies: Overview of Research Process
Advertisements

CSE594 Fall 2009 Jennifer Wong Oct. 14, 2009
The Writing Process Communication Arts.
Welcome to the seminar course
Your Poster Title Starts Here: Please Center and use Arial (Bold) 80 Authors & Affiliation (Arial 60) June 17-20, Mamaia Romania Your University Logo,
M. George Physics Dept. Southwestern College
Chapter 12 – Strategies for Effective Written Reports
Anatomy Laboratory Write up Emulate standard Scientific Paper (few exceptions)
Brief Overview of Aspects of the Scientific & Technical Literature.
Writing for Publication
The Writing Process.
The material was supported by an educational grant from Ferring How to Write a Scientific Article Nikolaos P. Polyzos M.D. PhD.
Announcements ●Exam II range ; mean 72
Group Project CVEN Mixing and Transport in the Environment. A River Dye Study.
Scholarship Skills Tim Sheard and Todd Leen 1 Lecture 2 Scholarship Skills Tim Sheard and Todd Leen 2006 PSU - OHSU All material © 1996, 1997, 1999, 2000.
Project Report1 Dave Inman Project report. Project Report2 Ways to write a report Top down: Write the structure of the report (maybe use the web templates.
Writing tips Based on Michael Kremer’s “Checklist”,
Basic Scientific Writing in English Lecture 3 Professor Ralph Kirby Faculty of Life Sciences Extension 7323 Room B322.
How to Read a Technical Paper Locking and Consistency 10/7/05.
Formal Lab Reports –Some personal comments –Structure First and foremost Know what it is to plagiarize Don’t do it !!! Disclaimer: This is not a substitute.
MBS Doctoral Research Conference: Briefing Professor Stuart Hyde Director of Postgraduate Research.
Experimental Psychology PSY 433
How to write a paper and get it published in a top journal….. and make sure it is cited…..
Dr. Alireza Isfandyari-Moghaddam Department of Library and Information Studies, Islamic Azad University, Hamedan Branch
The Chicago Guide to Writing about Multivariate Analysis, 2 nd edition. Paper versus speech versus poster: Different formats for communicating research.
The Writing Process My Favorite Things.
IMSS005 Computer Science Seminar
Writing Technical Papers CSCI 327. Outline for Today 1.Finding Appropriate Sources 2.Document Formatting Standards 3.Appropriate Writing Style 4.Typical.
IM-SURE Program The University of Montana Summer 2014.
AELDP ACADEMIC READING. Questions Do you have any questions about academic reading?
Planning & Writing Laboratory Reports A Brief Review of the Scientific Method.
Passive transport Active transport Exocytosis Endocytosis Membrane Transport.
Advanced Technical Writing
How to do Quality Research for Your Research Paper
11 Writing a Conference Research Paper Miguel A. Labrador Department of Computer Science & Engineering
How to read a scientific paper
APA/EL Style Guide workshop August What is the purpose of APA?
Time to Draft. What should I include in my introduction?
Chris Luszczek Biol2050 week 3 Lecture September 23, 2013.
1 CS 178H Introduction to Computer Science Research Why Do an Honors Thesis?
ABSTRACT Function: An abstract is a summary of the entire work that helps readers to decide whether they want to read the rest of the paper. (HINT…write.
How to start Milestone 1 CSSE 371 Project Info There are only 8 easy steps…
Basic Research Methods The “secret” –Build on the “magical” questions What’s the problem? Why’s the problem a problem? What’s the solution? Why’s the solution.
Scientific Paper. Elements Title, Abstract, Introduction, Methods and Materials, Results, Discussion, Literature Cited Title, Abstract, Introduction,
Researching & Writing a Literature Review Karen Ciccone NCSU Libraries.
Wednesday’s agenda: September 6  Discuss your summary/critique of the Michaelson chapter on the Incremental Method.  Discuss structure of theses and.
Essay Writing.
Personal Statement: How to write a personal statements for scholarships.
How to read a scientific paper
How to Read Research Papers? Xiao Qin Department of Computer Science and Software Engineering Auburn University
Scientific Communication
Chapter 22. 1) Select a topic 1) Select a topic that you can readily research. 2) Limit your topic 2) Limit your topic and make the purpose of your paper.
June REU 2009 How to Conduct Research Some Rules of Thumb.
SCIENCE FAIR Scientific Method The Science Fair is all about using the Scientific Method. Follow the steps below to ensure a successful Science Fair.
Scientific Papers Chemical Literature Prepared by Dr. Q. Wang.
Literature Search Bill Barrett (originator) David W. Embley (editor)
How to organize your notes When you are done reading this, you will know: Various ways to take notes How to keep track of your sources How to NOT screw.
Ian F. C. Smith Writing a Journal Paper. 2 Disclaimer / Preamble This is mostly opinion. Suggestions are incomplete. There are other strategies. A good.
Pointers for Papers. Using Tables & Figures Tables and Figures need: 1. A number and title (usually at top)  Refer to table by table number in the text.
Scholarship Skills Andrew Black 1 Lecture 13 Conference Papers Andrew Black & Tim Sheard Portland State University.
June REU 2003 How to Conduct Research Some Rules of Thumb.
Technical Report Outline Title Page Frontispiece Abstract Table of Contents List of Figures/ List of Tables.
1 Taking Notes. 2 STOP! Have I checked all your Source cards yet? Do they have a yellow highlighter mark on them? If not, you need to finish your Source.
Finding, Reading, & Citing Scientific Papers. Types of scientific literature? Primary literature ~ current, specialized, with data research articles,
Abstract  An abstract is a concise summary of a larger project (a thesis, research report, performance, service project, etc.) that concisely describes.
WORKSHOP ON LABORATORY REPORT WRITING
CSE594 Fall 2009 Jennifer Wong Oct. 14, 2009
Advanced Technical Writing
Technical Writing Abstract Writing.
CSE594 Fall 2009 Jennifer Wong Oct. 14, 2009
Presentation transcript:

Technical Writing for Computer Science Part 1: Content and Organization Research Careers Lecture Series July 13, 2009 Michael J. Lewis, Director Department of Computer Science Binghamton University (SUNY)

NSF REU Technical Writing CS Research Papers Every paper is different, but most should be organized like this: Abstract Introduction Related Work Design Implementation Performance Summary and Future Work References

NSF REU Technical Writing CS Research Paper (cont.) Abstract 150 – 300 words Identify the problem Some background OK, but get to the point Identify the key contribution explicitly don’t let others decide Don’t keep secrets… report the main results Many more people will read your abstract than your paper…

NSF REU Technical Writing Introduction Do not start with a quote! Provide some background (1-2 paragraphs) Get to the point Identify the problem (yes, again) Identify your contribution (yes, again) Preview most important results (yes, again)

NSF REU Technical Writing Related Work Report the background research Categorize other papers Briefly summarize them (1-2 sentences each is often all you have room for) Draw the most important distinctions with your work About ½ to 1 page…

NSF REU Technical Writing Related Work: How? People (your advisor, graduate students, other professors, etc.) Manuals, websites, specifications, etc. If it’s not officially “published,” be careful Use Wikipedia for trivia about Saturday Night Fever Do not use Wikipedia for CS background research Published research papers

NSF REU Technical Writing Why? Research must be new Otherwise it’s a waste of time Especially important if it’s an “old problem” Others have good ideas you can build on Reading other work can spark ideas (it can also inject biases, be overwhelming, etc…. no magic answer to this problem…) Others may identify problems for you They may also show which problems are “too hard” E.g. NP-Complete problems need heuristics

NSF REU Technical Writing CS Publications (from the “Publishing Game” talk...) Publication Venues Journals Conferences Workshops Technical Reports You have to find everything

NSF REU Technical Writing How do you find “everything” Build a list of venues that are likely to report research on this topic Talk to your advisor and other group members Browse conference lists, look at "Calls for Papers“ Browse by key words to find some recent papers Google, Google Scholar, INSPEC, ACM Digital Library, IEEE digital library Check the last several years of proceedings in these venues Online or printed copy in the library

NSF REU Technical Writing Find some papers Now get your hands on some papers Read them -- are they relevant? If so, they’ve probably cited relevant work Go find those papers, too Use the Related Work and Reference list of relevant papers, to find others Use title, author, conference, etc.

NSF REU Technical Writing Browse by Author or Group Make sure you get the latest work from the group or author of relevant papers Statements in a paper are only necessarily true at the time it is published “open problems” may be solved Performance numbers may be irrelevant “new” approaches may be old… Find the author or research group’s Web page Don’t count on it being up to date! Browse databases/libraries by author

NSF REU Technical Writing Shortcuts You will not be able to read everything thoroughly You don’t have to! (notice before I said you have to find everything) Read abstract, intro, related work, summary Then decide whether to read the whole paper Gold nuggets in your background research “Taxonomies”, or “Surveys” (not always called that) E.g. ACM Computing Surveys

NSF REU Technical Writing Use Citation Counts and Info Some papers will pop up over and over Make sure you read and cite these If only for practical reasons… for reviewers to see… Google scholar and Citeseer Reports citation counts Read and cite the heavily cited papers (see above) Allows you to browse by “Cited by…” If others are citing the same work you are, they might be working on similar problems

NSF REU Technical Writing Writing a Related Work Section Group and categorize other approaches Distinguish your work succinctly Be diplomatic and nice Start with the most “important” work If something is very closely related Describe it in more detail Be more specific about differences Make it clear why (you think) your paper is novel

NSF REU Technical Writing Brief aside… Make it easy for others to find your work Pick good titles for your papers Post your papers on a web page Post full citations on your page So others can simply cut and paste into their papers It’s easier to stay “current” than to get current Track top conferences, related groups, and authors Seek them out at conferences and talk to them Potential for collaboration Staying current is like eating healthy and exercising…

NSF REU Technical Writing Design and Implementation Depend heavily on content of the paper Best to separate Design from Implementation But not always… and sometimes impossible Not every implementation detail is important Focus on those that are novel and important to the contribution of the paper

NSF REU Technical Writing Performance Clearly describe your experimental setup Ideally others should be able to reproduce your results Computer scientists seldom achieve this goal Then describe your results Capitalize “Figure 1” but not “this figure” ALL figures and tables should be called out in the text Interpret the results and “lesson” of every graph, figure, table, etc. Don’t require the reader to do this for himself or herself…

NSF REU Technical Writing Summary and Future Work Say what you’re going to say (Intro) Say it (Body) Say what you said (Summary) Summaries are not Conclusions Draw conclusions throughout the paper Future Work Show that there’s more to do… don’t reveal too much

NSF REU Technical Writing The Process You do not need to set aside a whole day! Write in small blocks of time Reread often, later, on paper… Get a first draft done, somehow, fast This is the “clay” to sculpt from But be willing to throw away most of it eventually

NSF REU Technical Writing Miscellaneous ideas Be clear… “Hold the reader’s hand” Assume your reader is lazy Make it easy to find the information Focus on contributions, not the journey Name new things… acronyms, capital letters, descriptive names, bold face or italics (the first time), etc.

NSF REU Technical Writing Other Sources How (and How Not to) Write a Good Systems Paper A classic… still relevant Writing a Technical Paper, by Michael Ernst