: Re: 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

@Carla500

Vote Up Vote Down

I think it's fine, because you as a company are creating an instruction manual which is going to be used by specific people. It's not literally a public Wikipedia.

To make it as clear as possible, start with the kind of disclaimer you sometimes see in plain-English contracts: "You, Your, Yourself, etc. refers to the developer."

When you're done writing, go back and search for any instance of "the developer" and see if changing it to "you" makes it read more smoothly or makes it clearer.

(0)

Login to post a comment!