Human Physiology/Formatting

Goal: Excellent Writing Style

edit

One of the challenges we face in making this textbook is creating chapters that flow logically from one to another and that maintain a consistent format and style throughout. We can begin by making sure our individual chapters are as well-written as possible. This is not an English class, but we are all using writing as a teaching and learning tool and will gain more from this process if we pay attention to the quality of our writing. To guide us in this process, here are descriptions of outstanding writing and weak writing, from my colleague N. Straight, who teaches in the English department.

Outstanding

edit
The essay will be thoughtfully structured with logical and coherent organization, have an excellent beginning and ending, and earn its conclusions. [. . .] There will be smooth transitions, varied and forceful sentences, fresh diction, compelling voice, and an appropriate tone. The reader will respond by thinking seriously and critically about the arguments.

Weak

edit
The writing is unfocused, and the thesis is too general, vague, or confusing. Weak writing often begins with a thesis that is a topic rather than an argument. The argument may be incomplete or superficial, with flawed reasoning and insufficient supporting detail. There may be areas where the writer supplies inappropriate or extraneous information. The writer does not really have a point to make, or the essay merely exploits the obvious. This writing may be largely summary or description rather than argumentation. There are major errors in mechanics, usage, logic, or sentence structure that interfere with the communication of the argument.

Templates for use: A note from Whiteknight

edit

Your Human Physiology book looks fantastic! I am very impressed with all the work that is being put into it. Because all your students are getting more advanced with editing here, I wanted to point out some useful templates that Wikibooks provides for working with text:

This is a floating box on the left.

Also, you can create floating text boxes on the left or the right side of the page. The text from your page will automatically wrap around this floating boxes. To create a floating box on the left, use {{SideBox|float=left|YOUR TEXT}}


This is a floating box on the right

However, if you want to create a box on the right, you can use the template {{SideBox|YOUR TEXT}} to put it on the right. Inside a floating box, you can use formatting like normal. Here is a good example:


Sections to Include in Each Chapter

edit
When Kevin was 14 years old he started having "stomach pains" a week after returning from a family vacation to Disney World. After three days the pain was intense and he went to bed early. The next morning when he awoke, he realized immediately that the pain in his lower right abdomen was even worse than when he went to bed the night before. Now the pain was accompanied by nausea and fever. He went to the kitchen and tried drinking a little juice, but promptly vomited. A few minutes later an excruciating wave of pain shot through his abdomen. He let out a scream, fell to the ground, and passed out. When he awoke his mother was standing over him and said, "okay, you can miss school today, but that's it!" What do you think may be causing Kevin's pain? Should his mother take him to a doctor? A hospital? Or just send him to bed?

The true story (about me!) in the sidebox is to remind you to make a little case study at the start of your chapter to draw your reader in. We want our chapters to be so compelling that readers will be anxious to read more. We want our chapters to be so well-organized and well-written that readers will easily gain new understandings about how the body functions. We want them to see new connections between body systems and be in awe of the millions of chemical reactions that are continuously happening within their cells to keep them alive. ~Kevin

Overview

edit

A single paragraph that describes your system in a nutshell, and perhaps highlights some key physiological processes that will be introduced

Headings and subheadings for your content

edit

Note that this is a subheading. Headings have two = signs on each side and show up as a distinct section with a line beneath.

Review Questions

edit

We will have an appendix to enter your answers to review questions. Should we do open-ended questions? I think that would be easier than multiple-choice.

Glossary or Key Terms

edit

What do you think we should call this section? Where should we put it? I prefer it at the end of the chapter so it is out of the way but easily found if you need it, but others might feel it is best at the beginning of the chapter so you can have an overview of the vocabulary before you dive into the content.

Formatting for the glossary should be consistent between chapters (hit "edit" to see code)

human physiology
study of the functions and processes of the human body
Phrynosoma
The genus of a group of 14 species of horned lizards, commonly referred to as "horny toads"

References

edit

I want you to reference quotes or ideas with footnotes and and references. Hit "edit" to see the code for formatting. First put in a reference in the form:

"This lizard eats ants!"[1]

That makes a superscript number that your readers can click on. Then at the end of your file put in the note:

If you have a long block of text that you are quoting (try to avoid this, but sometimes it is useful), then you don't put quotation marks but instead indent the entire quote by putting a colon directly in front of it.

Footnotes could be a separate subheading under References. Maybe put books under the "References" section, Footnotes here, and then external links below. In writing footnotes, remember the pound sign (#) to make the matching number appear.

Footnotes

edit
  1. ^ Young, K.V., "Food Habits of Ant-Eating Lizards" Journal of Very Specialized Research, 2006.
edit

Professional Associations

edit

Other?

edit

Share your thoughts about other formatting questions either by directly editing this page or contributing to the discussion tab for it. Provophys 22:42, 1 August 2006 (UTC)

I'm thinking it would be good to have links to some professional journals and professional associations for people who take a particular interest in the topic, as well as any high-quality external links that would provide additional information to interested readers. Provophys 02:35, 3 August 2006 (UTC)