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 Is it acceptable to mix how you address the reader in an instructional Wiki?

I'm working on a Wiki article that explains to new developers how our product life-cycle works. Originally, my goal was to completely avoid the word "you" and use a more general description like "...

2 answers  ·  posted 13y ago by ray023‭  ·  last activity 5y ago by System‭

Question style viewpoint
#3: Attribution notice added by user avatar System‭ · 2019-12-08T01:47:45Z (about 5 years ago)
Source: https://writers.stackexchange.com/q/3463
License name: CC BY-SA 3.0
License URL: https://creativecommons.org/licenses/by-sa/3.0/
#2: Initial revision by user avatar ray023‭ · 2019-12-08T01:47:45Z (about 5 years ago)
I'm working on a Wiki article that explains to new developers how our product life-cycle works.

Originally, my goal was to completely avoid the word "you" and use a more general description like "the developer".

The more I write though, the more useful I find the word "you."

And now I'm doing a mixture of both.

For instance, I may start a description of a new topic by saying the following:

> This phase requires **the developer** to obtain a firm grasp on _blah blah blah_

Then, the first sentence of the next paragraph looks like this:

> By the time **you** receive a Change Request, the A & D department will have a Functional Specification ready for review.

My general questions is this: Is it acceptable to jump between "the developer" and "you"?

When I read it, it seems to flow fine, but I would love some feedback on this approach.

#1: Imported from external source by user avatar System‭ · 2011-07-27T15:39:44Z (over 13 years ago)
Original score: 4