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

Post History

50%
+0 −0
Q&A Rewriting User Guides as Stories

I'm increasingly having to write User Guides as part of my job and I need routes to make this into a more interesting exercise. Hence, I was actually looking for something completely different whe...

2 answers  ·  posted 6y ago by robertcday‭  ·  last activity 4y ago by System‭

#3: Attribution notice added by user avatar System‭ · 2019-12-08T08:57:00Z (over 4 years ago)
Source: https://writers.stackexchange.com/q/36510
License name: CC BY-SA 3.0
License URL: https://creativecommons.org/licenses/by-sa/3.0/
#2: Initial revision by user avatar robertcday‭ · 2019-12-08T08:57:00Z (over 4 years ago)
I'm increasingly having to write User Guides as part of my job and I need routes to make this into a more interesting exercise.

Hence, I was actually looking for something completely different when I started writing this question such as 'can I use humour in technical writing?' but found that this had already been asked ([How much humour is **effective** in technical documentation?](https://writing.stackexchange.com/questions/33524/how-much-humour-is-effective-in-technical-documentation)) with the answer being a resounding _no_ (aside from X for Dummies books).

So then I was thinking about asking a question like 'Can I make User Guides more _engaging_?. I was beaten to the punch by this engaging question: [Can technical writing suck less](https://writing.stackexchange.com/questions/21091/can-technical-writing-suck-less). The answers this time were along the lines of 'yes, but not with humour'.

And then I saw this (from [Michael](https://writing.stackexchange.com/users/16176/michael)):

> One example that sprung to mind is the instructions or "rules" for games. Some of these books can be so engaging that a lot of fans just read the rulebooks without actually playing the games (I know I have, and I notice people on discussion forums for e.g. roleplaying games reporting the same fascination).

And this led me to wondering about writing rule books that are so entertaining that they are capable of being read in much the same way that stories are. So, here (finally) is my question: How challenging would it be to rewrite a (random) User Manual as a tale of derring-do and intrigue? In other words - what would be the best technical approach to rewriting a User Guide as a Story?

Yeah, it's too broad, innit! Specifically, then - how can I wrap a plot around something that is plotless? Or insert characters into something that has no such beasts? Hmm.

I suppose what my question comes down to is this: 'what is the difference between 'technical writing' and 'creative writing' and how can I close that gap, in terms of converting one to the other'?

(Posts question and then nips over to Warhammer to see how they do it there.)

#1: Imported from external source by user avatar System‭ · 2018-05-29T10:18:59Z (almost 6 years ago)
Original score: 4