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

In a FAQ, should a question header take the form "Why does blah blah?" or "Blah blah happens, Why?" And why?

+1
−0

Whilst writing technical documentation, there is commonly a section on troubleshooting or frequently asked questions.

I know a FAQ should be real questions - not ones the publisher thinks might be asked.

But when wording the question header, should it take the form:

Why does blah blah happen? 

or

Blah blah happens, Why?

The former might be a more natural way of simply asking the question.

In the latter the thing that is happening appears earlier in the phrase making it easier for readers to recognize relevance earlier. That's especially the case if there's a long list of questions, where it might appear odd to have every question starting Why, How, etc.

I'm also wondering about 'a third way'!

Blah blah is happening.

I can't find the blah blah.

The fact that it's in a FAQ implicitly suggests this is a question, so maybe it's enough to say what is happening, without explicitly wording it as a question.

What would be recommended, and why?

History
Why does this post require moderator attention?
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/10577. It is licensed under CC BY-SA 3.0.

0 comment threads

0 answers

Sign up to answer this question »