GTE Technical Writing Workshop: Carol Piedra & Esteban Solorzano

GTE Technical Writing Workshop
Carol Piedra & Esteban Solorzano
1 Boston Scientific Confidential -- For Internal Use Only. Do Not Copy, Display or Distribute Externally
Agenda
Why we do writer papers?

GTE Paper structure
Editing (Web Layout)
Captions for tables and figures
Raster vs Vector and Image
References (Zotero)
Information Sources
Breaking the ice with Mindmapping
Intellectual Property
Why do we write papers?
Create new knowledge and disseminate it.
Impact on reader:
An individual can pick up paper and glean any useful information with as little effort
as possible.
For another researcher in the field, a read of the abstract and a skim of the results
should be sufficient to grasp the paper.
For a non-expert, the introduction and discussion should fill in any gaps in their
knowledge (to a reasonable extent).
Help others from reinventing the wheel and foster collaboration.
Obtain critical reviews and feedback from around BSC.
Establish credentials: Make the world aware of what we are working on.
It's also fun!

GTE Paper Structure
I. BACKGROUND
II. BODY OF PAPER
III. TOOLS USED
IV. RESULTS
V. CONCLUSIONS
Editing (Web Layout)
Web Layout view allows to focus on the content of the paper, not in type
setting.
Type setting: Text formatting should be done last
Paragraph Marks Icon
Allows to improve the available physic space in the worksheet
Document control while writing the paper
Captions for tables and figures
Each figure and table will be linked to their respective description
Numbering sequence in constant change automatic updates (F9)
Raster vs Vector and Image
Raster (Bitmap)
A raster image is defined by pixels. A pixel is the smallest display

element that makes up the images seen on a computer monitor or
television. In raster images, the more pixels an image contains, the
higher its resolution.
Raster images are the best choice for creating subtle gradations of
shades and color, such as in a photograph.
A raster image is resolution-dependant because it contains a fixed

number of pixels that are used to create the image.
Vector (Lines/Calculated Points)
A vector image is defined by objects which are made of lines and curves
that are defined mathematically in the computer. Vectors can have
various attributes such as line thickness, length and color.
Vector graphics are resolution-independent because the vector objects
are drawn mathematically in the computer. They can be made larger or
smaller without any loss of quality to the image. Vectors can be printed
at any size, on any output device, at any resolution, without losing detail
and without altering the resolution of the image.
Vector images are the best choice for typefaces, charts and graphs,
drawings, and other graphics that must have sharp lines when scaled to
various sizes.
Even though word processing programs such as MSWord are not
drawing programs, they too use vectors because they use fonts and
fonts are vector files! Fireworks is unique in that it works with both raster
and vector art.
Raster vs Vector
Raster vs Vector Images
Raster vs Vector
Raster vs Vector
Raster Programs
Photoshop
Fireworks
Paint
Vector Programs
Illustrator
Flash
Inkscape open source software similar to Adobe Illustrator (Tiros favorite)
Raster vs Vector
Raster file extensions

Png portable network graphic
Psd Photoshop document
Jpg joint photographic experts group
Gif graphics interchange format
Bmp Bitmap
Vector File Extensions

Ai Adobe Illustrator
Eps Encapsulated Postscript
Wmf Windows Metafile
The Visual Display of Quantitative
Information
Good graphics
Napoleans invasion of Russia, as drawn by Charles Joseph Minard

(1781-1870)
More good graphics
The price of wheat compared to labour wages, William Playfair (1759-

1823)
More good graphics
French train schedule, as drawn by E.J. Marey (1830-1904)

More good graphics
Map of the northern

galactic hemisphere
(1.3 million galaxies
shown)
What made these graphics good?
Bad graphics
More bad graphics
More bad graphics
What made these graphics bad?
How can we make better
graphics?
Edward Tuftes principles of data graphics
Above all else, show the data
Maximize the data-ink ratio
Erase non-data-ink
Erase redundant data-ink
Revise and edit

Above all else, show the data
Show the data
Data-Ink
Ink that changes as the data changes
Non-redundant ink!
Data-Ink Ratio
data-ink
Data-ink ratio
= Total ink used to print
graphic
= Proportion of a graphics
ink devoted to the non-
redundant display of
data-information.
= 1.0 proportion of
graphic that can be
erased without the loss of
information
Ratio of Histogram
What is the data-ink ratio of this graphic?
<
0.05 !!!
Ratio of USA Today Graphic
What is the data-ink ratio of this graphic?
<
0.001
How can we make better graphics?
Tufte presents some principles of data graphics

Above all else, show the data.
Within reason
Every bit of ink on a graphic requires a reason
Erase non-data-ink
Revise and edit

Erase non-data-ink
Revise and edit
Erase non-data-ink, within reason
Histogram of Midterm Results
18
# of Students
11
2
1
0
C B- B B+ A- A
Scoring Buckets
18
# of Students
11
2
1
0
C B- B B+ A- A
Scoring Buckets
18
Whats the
data-ink
# of Students
11 ratio?
7
2
1
0
C B- B B+ A- A
Scoring Buckets

Erase non-data-ink
Revise and edit
The Principles Applied to Common Forms
Box Plots
Maximum
75%
Media
n
25%
Minimum
Box Plots
Maximum
75%
Media
n
25%
Minimum
Bar Graphs
Modified
Graph
Original
Graph
Scatter Plots
Modified
Graph
Original
Graph
Another Scatter Plot Variant
Conclusions
Show data variation, not design variation

Avoid using ink for non-data items
Avoid redundancy
Clear and detailed labeling should be used to
defeat graphical distortion
Revise and Edit
Smart way to manage references
the next-generation research tool
www.zotero.org
works with...
most library catalogs
and hundreds of
other sites and
57
databases...
Boston Scientific Confidential -- For Internal Use Only. Do Not Copy, Display or Distribute Externally
Information Sources
Bibliographic References
BSC Intranet Resources Library and Knowledge Services
Library@bsci.com
But Tiro! I cant think clearly on what to write!
(Psychological inertia)
Breaking the ice with Mindmapping
Why Mind Map?
Organize thoughts when brainstorming

Effective method of taking notes
Harnesses the full range of cortical skills word, image, number, logic, rhythm,
color and spatial awareness
Aid creativity, memory, and specifically the recall of information

GTE Technical Writing Workshop: Carol Piedra & Esteban Solorzano

Загружено:

Сведения о документе

Исходное описание:

Оригинальное название

Авторское право

Доступные форматы

Поделиться этим документом

Поделиться или встроить документ

Параметры публикации

Этот документ был вам полезен?

Это неприемлемый материал?

Авторское право:

Доступные форматы

GTE Technical Writing Workshop: Carol Piedra & Esteban Solorzano

Загружено:

Авторское право:

Доступные форматы

GTE Technical Writing Workshop

Carol Piedra & Esteban Solorzano

Why we do writer papers?

Help others from reinventing the wheel and foster collaboration.

Obtain critical reviews and feedback from around BSC.

It's also fun!

II. BODY OF PAPER

III. TOOLS USED

Type setting: Text formatting should be done last

Allows to improve the available physic space in the worksheet

Document control while writing the paper

Numbering sequence in constant change automatic updates (F9)

A raster image is defined by pixels. A pixel is the smallest display

A raster image is resolution-dependant because it contains a fixed

Raster file extensions

Vector File Extensions

Napoleans invasion of Russia, as drawn by Charles Joseph Minard

The price of wheat compared to labour wages, William Playfair (1759-

French train schedule, as drawn by E.J. Marey (1830-1904)

Map of the northern

Above all else, show the data

Maximize the data-ink ratio

Erase redundant data-ink

Revise and edit

Ink that changes as the data changes

What is the data-ink ratio of this graphic?

What is the data-ink ratio of this graphic?

Tufte presents some principles of data graphics

Tufte presents some principles of data graphics

Histogram of Midterm Results

Histogram of Midterm Results

Histogram of Midterm Results

Tufte presents some principles of data graphics

Another Scatter Plot Variant

Show data variation, not design variation

BSC Intranet Resources Library and Knowledge Services

Organize thoughts when brainstorming

Вам также может понравиться