Communities

Writing
Writing
Codidact Meta
Codidact Meta
The Great Outdoors
The Great Outdoors
Photography & Video
Photography & Video
Scientific Speculation
Scientific Speculation
Cooking
Cooking
Electrical Engineering
Electrical Engineering
Judaism
Judaism
Languages & Linguistics
Languages & Linguistics
Software Development
Software Development
Mathematics
Mathematics
Christianity
Christianity
Code Golf
Code Golf
Music
Music
Physics
Physics
Linux Systems
Linux Systems
Power Users
Power Users
Tabletop RPGs
Tabletop RPGs
Community Proposals
Community Proposals
tag:snake search within a tag
answers:0 unanswered questions
user:xxxx search by author id
score:0.5 posts with 0.5+ score
"snake oil" exact phrase
votes:4 posts with 4+ votes
created:<1w created < 1 week ago
post_type:xxxx type of post
Search help
Notifications
Mark all as read See all your notifications »
Q&A

Is it necessary to explain what is written in upcoming chapters?

+1
−0

When writing a technical report, is it necessary to explain what is written in upcoming chapters?

For example in my introduction chapter, I may have a sub-chapter called "Forthcoming chapters" which will explain what each forthcoming chapter will discuss. So something like "My methods chapter will explain the methods of my investigations..."

I've seen examples where people have done this but to me it all seems "obvious" about what a methods chapter should contain.

Does it improve the technicality, eloquence or the professionalism of the report?

History
Why does this post require attention from curators or moderators?
You might want to add some details to your flag.
Why should this post be closed?

This post was sourced from https://writers.stackexchange.com/q/19709. It is licensed under CC BY-SA 3.0.

0 comment threads

1 answer

+0
−0

First, if your institution has a style guide, follow its recommendations if there are any. But assuming it is silent on this point or you don't have one:

It's helpful to provide an outline of the rest of the report. If you have a table of contents already that might be good enough (I've seen TRs with and without TOCs). If you include something at the end of the introduction, though, avoid the "department of redundancy department" problem.

Bad: "Chapter 2, Methods, explains the methods of my investigation." You haven't said anything that wasn't already implied by the title.

Better: "Chapter 2, Methods, explains how we used the (something) method to (something)." The key here is to add something to "methods" -- name the method, say something about important factors for that method if relevant ("ran a trial with 4 groups for a 12-month period"), or otherwise tell people something about your methods right there in the summary. This lets the reader who already knows what the (something) method is to go straight to the results if he wants without having to wonder if they're at all valid. (An interested reader may go back and read your methods later, of course.)

So, more broadly, the point of a "here's what's in the rest of this document" section is to provide short hints that are meaningful enough to let people skim and jump to the parts they're most interested in.

Finally, the size of this short hint can scale somewhat with the size of the document. If your TR is 5 chapters in 30 pages, one sentence per is probably fine. But if it's 5 chapters in 300 pages, you might find it useful to drill down a bit and write a paragraph or so for each. Think of them like mini-abstracts for each chapter. As with an abstract, the reader question you're trying to answer is "do I want to read this?".

History
Why does this post require attention from curators or moderators?
You might want to add some details to your flag.

0 comment threads

Sign up to answer this question »