👌 IMPROVE: Use consistent tense/perspective throughout tutorial #360
Labels
priority/nice-to-have
Nice improvement, but no biggie
section/all
Applies to all sections
type/improve
Improving already existing content
@CasperWA raised a good point regarding the inconsistent use of "we" vs "you" here:
#353 (review)
Since this is rather up to personal preference, we're probably mixing the use of "we" vs "you" quite a bit. @CasperWA indicated that he prefers "you", but here it is claimed that using "we" promotes a personal relationship between the speaker and audience:
https://ux.stackexchange.com/a/57309
I was also a bit more partial to using "you" for instructions, though. This React tutorial (which I think reads nicely) also uses both "we" and "you":
https://reactjs.org/tutorial/tutorial.html
"We" is more used for general statements, like:
Or actions from the authors:
Whereas "you" is used more for addressing the user:
or suggested actions:
Finally, the imperative mood is used for instructions:
It's probably a challenge to write down an unequivocal style guide for this. Maybe someone has already given this some more thought or knows a good resource for this? Going over the material and trying to make it more consistent is probably a good exercise at some point.
The text was updated successfully, but these errors were encountered: