| * 1Overview | ||
| * 2Before you get started... | ||
| * 2.1Reading assignments | ||
| * 2.2LaTeX template | ||
| * 2.3Accessing references from home | ||
| * 2.3.1UChicago Library | ||
| * 2.3.2UChicago Virtual Private Network (VPN) | ||
| * 3First draft (25%) | ||
| * 3.1Article proposal | ||
| * 3.2First draft | ||
| * 3.3Self-evaluation | ||
| * 3.4Your first draft grade | ||
| * 4Peer review (50%) | ||
| * 4.1Reviewing your classmates | ||
| * 4.1.11. Completeness | ||
| * 4.1.22. Technical evaluation | ||
| * 4.1.33. General comments | ||
| * 4.1.44. Direct annotations | ||
| * 4.2Your peer review grade | ||
| * 5Final draft (25%) | ||
| * 5.1Final draft | * 5.2["Letter to the editor"](#JournalArticleandPeerReviewOverview-"Lettertotheeditor") | * 5.3Your final draft grade |
In most professional communities, articles submitted to journals are subject to a process known as peer review. In this process, reviewers (also sometimes called referees) read over the paper to determine whether the article is appropriate for publication in that journal and, if so, provide suggestions for improvement. When done well, the peer review process improves the quality of all papers in the field by ensuring that work which is published is honest, accurate, and easy-to-read.
In PHYS 211, we want to introduce you to the process of writing a journal article and undergoing (and participating in) peer review. By seeing the work of your classmates and by getting direct, constructive feedback, you will hone your scientific communication skills.
The writing and peer review process is broken up into several phases. Your journal article and your participation in the peer review process will together carry the same weight as a normal experiment. (That means that this quarter you will have three grades total – two experiments and this assignment.)
The weight is broken down as follows:
We will look at each part in more detail below, but let us highlight the _technical _requirements for each assignment here so that you can easily consult them as you work on this project.
Technical Requirements (Quick Reference)
Article proposal
First draft
Self-evaluation
Final draft
Letter to the Editor
Since science communication is somewhat different from other types of writing – like a history report or an expository essay – we'd like you to read over the following two short pieces:
| * "The Science of Scientific Writing", an article by George G. Gopen and Judith A. Swan, (1990). |
| * "Presenting your Results", an excerpt from Chapter 3 of the book Experimental Physics by Walter F. Smith (ed.), 2020. |
There is no assignment to complete, but we do strongly encourage you to read these carefully and reflect on both what you find interesting and what you find useful advice as you start your writing project.
| If you were a student in PHYS 211 last quarter, then you already completed the My First LaTeX Document assignments and you should be ready to typeset in LaTeX by copying and modifying that document. |
| If you were not a student in PHYS 211 last quarter, you should check out that page and work through the assignments to become familiar with Overleaf and with LaTeX in general. (Start early – in case you have questions – but the two assignments should each take only about 1 hour or less.) |
Regardless, we are providing a full Overleaf template for you just in case you were unable to do something you wanted to in the assignment (or in case you deleted the documents from last quarter). Click the link below to view the template, then make a copy in your own Overleaf account:
Most published journal articles are not freely available. However, the University pays subscription fees for access to many journals and you can view individual articles either by retrieving them through the Library's website or by first logging on to the University of Chicago Virtual Private Network. An overview of options is available here on the University Library page, but we will summarize the two methods below.
To access an article through the Library website if you are not on a campus network…
Logging into the University's VPN reroutes your internet connection and provides you with a University of Chicago IP address that allows you to access resources as though you were on a University Network-connected computer (like a computer in the Library or the UChicago wifi network).
If you already have VPN set up, then this an even simpler way to access journal articles; all you need to do is find the article either on the Library website or on the journal's own website, and you will have the correct privileges to access it without additional login barriers. However, setting up the VPN for the first time is a little bit difficult (and when connected, all your traffic – not just article searches – are routed through the University network… which you may or may not be comfortable with). If you want to try it anyway, information on how to set it up is provided here.
Look over the experiments you completed in Autumn and Winter quarters and choose one to expand into a full paper. A suitable experiment should be one that you understand very well, but for which there is still something that can be improved upon as you expand it into an article. (We do not mean that you need to collect more data or do new analysis… we mean that there is something about the writing, data presentation, discussion, etc. that can be improved. Examples might include figures that can be redone to be easier to understand, a more complete uncertainty analysis, further comparison of data to predictions, a more complete description of a technique used, etc. Look specifically at TA feedback for other suggested improvements.)
Avoid choosing a report that was low-scoring or where you feel like there were issues with the underlying data or analysis.
The proposal should be short and include the following:
You may write the proposal in whatever program you want – Microsoft Word, LaTeX, Google Docs, etc.
Peer review only works if you submit a finished version of the report for review. Therefore, the grade for your first draft is based entirely on whether or not you submit a complete article. Each of your two peer reviewers and the TAs/lab staff will evaluate whether the draft is complete and provide a score.
A complete draft is not necessarily one that is ready to be published. Instead, it is a draft that has complete and well-considered sections; all the relevant figures, tables and captions; a full set of appropriate references; and no missing text or incomplete arguments. It should be formatted correctly and overall look “presentable”.
The self-evaluation serves several purposes:
The self-evaluation is not super-formal, but should written in full sentences and paragraphs (not fragments or bullet points). It should be about one or two pages; use as much space as you need to make your points. You may write it in whatever program you want – Word, LaTeX, etc.
Your first draft submission will be evaluated based on the following rubric with the usual 0-4 point scale. The final grade will be assigned based on the average (on a 4.0 scale) over all rubric items with completeness worth 3x the weight of all other categories.
| Item | 4 | 3 | 2 | 1 | 0 |
| Article proposal | Submits a complete proposal that articulates the reasons for choosing the topic, lays out a reasonable outline, and provides several annotated references. | Submits a complete proposal, but which lacks depth in one of the proposal items. | Submits a complete proposal, but which lacks depth in more than one proposal item. | Submits a proposal, but is missing one or more items or shows an overall superficial level of detail in most or all items. | Submits no proposal, or submits a proposal that is functionally incomplete. |
| Completeness (Carries 3x the weight of all other categories) | Submits a full article that is functionally complete with no missing sections; no missing figures, tables or captions; and no incomplete text or arguments. | Submits an article containing all sections, but which has incomplete or insufficient text in places, is missing an essential component (like a figure or table), or is significantly too long or too short. | Submits a report with one or more sections missing or under-developed. | Submits an article, but leaves large gaps in presentation that make the article feel rushed or poorly thought-out. | Submits no article, or submits an article that is functionally incomplete. |
| Self-evaluation (reflection) | Submits a self-evaluation that explains well the work done to transform the analysis into a journal article and details specific changes. | Touches on reflection, but does not explain well or fully. | Reflection is present, but muddied. | Attempts reflection, but only superficially. | Submits no self-evaluation, or evaluation contains no reflection on changes made. |
| Self-evaluation (reviewer guidance) | Submits a self-evaluation that explains well the places in the paper where the reviewer should pay particular attention and provide feedback (both positive and negative). | Provides some reviewer guidance, but does not explain well or fully. | Guidance is present, but muddied. | Attempts to provide guidance, but only superficially. | Submits no self-evaluation, or evaluation contains no reviewer guidance. |
Each peer review will contain the following four parts:
You will be graded for this part on completeness and quality of feedback. Your comments and scores will not affect the grade received by your classmate. Their comments will not affect your score. Be honest, but keep in mind that peer reviews are not anonymous; your feedback should be civil and constructive.
Guidelines for these four parts are as follows.
Evaluate the completeness of the article based on the following rubric.
| Item | 4 | 3 | 2 | 1 | 0 |
| Completeness | Submits a full article that is functionally complete with no missing sections; no missing figures, tables or captions; and no incomplete text or arguments. | Submits an article containing all sections, but which has incomplete or insufficient text in places, is missing an essential component (like a figure or table), or is significantly too long or too short. | Submits a report with one or more sections missing or under-developed. | Submits an article, but leaves large gaps in presentation that make the article feel rushed or poorly thought-out. | Submits no article, or submits an article that is functionally incomplete. |
If you score the paper lower than a 4, provide a comment explaining why.
Examples (a non-exhaustive list) of why a paper may be score less than the full 4 points include the following:
Examples (a non-exhaustive list) which do not make the paper incomplete (and for which you should not take points off) include the following:
If any of the above (or similar) apply, you should make a comment in the general comments section or a direct annotation. You should not deduct completion points. If you have questions, please ask the lab staff for help.
Consider the following questions and evaluate the report as a whole on the scale provided. Remember, the scores you give will not affect the person’s grade and are meant only to help in completing revisions.
In addition to the rubric score, you should give comments in each category detailing why you awarded the points you did.