View source for Writing in the Sciences

= Writing in the Sciences =

This is a mirror of the [https://share.coursera.org/wiki/index.php/Sciwrite:Main Writing for the Sciences Coursera class wiki]. 

Welcome to the Writing in the Sciences’ wiki. Feel free to create pages as needed. To see how to edit and add pages you can look at the [[Help:Editing | Help]] page on the left bar.

Good writers have: * Something to say. * Logical thinking. * A few simple, learnable rules of style

This course focuses on those rules. '''Writing is a competency that can be learned with practice.'''

The benchmark for our writing is ''what the reader understands'', that is, the ability to communicate an idea clearly and effectively in an elegant way. The former requires clear thinking and the latter revision and a good editor.

<blockquote>''Complex ideas don’t require complex language. Scientific writing should be easy and even enjoyable to read.''
</blockquote>
= Principles of effective writing =

In this course we will be focusing on three principles:

* [[Sciwrite:Cutting the clutter | Get rid of the clutter]]
* [[Sciwrite:Active voice | Use active voice]] (subject + verb + object)
* [[Sciwrite:Verbs | Write using verbs]]: strong verbs, avoid turning verbs into nouns, and don’t bury the main verb.

We also have some grammar tips relevant for scientific manuscript: * [[Sciwrite:Grammar tips | Grammar tips]] * [[Sciwrite:Punctuation| Punctuation]] * [[Sciwrite:Parallelism| Parallelism]]

How to write paragraph: * [[Sciwrite:Paragraph | Paragraph]]

= The Writing Process =

# Prewriting
# Writing
# Revision

= Recommended Writing Order =

# Figures and Tables
# Results
# Methods
# Introduction
# Discussion
# Abstract

= How to learn =

Writing for the Sciences employs cognitive learning methodologies which enable students from all walks of life to learn through listening, watching, reading, and interacting with information.

Some advices on how to learn to write in the sciences include:

* Read and listen.
* Research your topic.
* Define terminology.
* Discuss your research.
* Write and review.
* Engage your readers.
* Avoid the “muse.”
* Accept the complexities of writing.
* Revise. Elegance happens on revision, not the first draft.
* Learn how to remove the clutter.
* Utilize a good editor.
* Take risks (find your voice).

= Computer tools for better scientific writing =

I have turned some of the advice from the first module into scripts you can “run” on your plain text files.

https://github.com/ivanistheone/writing_scripts

= Examples of what not to do =

Some examples in scientific literature represent common errors: * The first sentence is often long and unengaging * Spunky verbs become clunky nouns * Use of vague words * Use of unnecessary jargon and acronyms * Passive voice (more detail later) * Distance between subject and main verb (more detail later)

= Books on writing =

* The Chicago Guide to Communicating Science, Scott L. Montgomery, The University of Chicago Press, 2003.