Talk:Style Guide

From Project-GC
Revision as of 12:12, 14 December 2021 by Optimist on the run (6278087) (talk | contribs) (Reply)
Jump to: navigation, search

Re: "When to link wiki-articles vs when to link main site". I'm thinking maybe just link inside the wiki everywhere except for the article about the actual tool/page/etc? My assumption is that people generally want to "stay in the wiki" when clicking stuff but I might be wrong? --Pleu (4523550) (talk) 22:36, 2 March 2021 (CET)

Yes, I agree. Even if people want to have a link to the site, then it is only one extra click to go to the wiki page, then to the tool/page itself. I would also assume that references to the geocaching.com site are linked to the wiki page about geocaching.com too, unless it is a specific page (a bookmarklist, home location etc.). DrAcorn (15789140) (talk) 12:08, 4 March 2021 (CET)

"You" or "the user"

Some pages like BadgeGen have been changed from the second person to the third person - e.g from "Once you have Ruby or higher you will unlock Addons" to "Once the user has Ruby or higher they will unlock Addons". This is acceptable for formal writing like Wikipedia, but for an instruction manual like this I think referring to readers in the second person is easier to understand.

For example, "To achieve the diamond badge, you need to log 5000 finds", or better still "Log 5000 finds to achieve the diamond badge."

What do others think? Optimist on the run (6278087) (talk) 10:49, 14 December 2021 (CET)

I agree. I believe the current change comes down to whatever happened to feel natural to the user editing. Sadly most of us don't speak fluent and/or native English, which affects the flow. I know myself having issues expressing myself at least, sometimes re-ordering a sentence multiple times to achieve something that I feel readable. But, this is probably something to try keep in mind. I have personally been fighting myself on the matter of not having the texts sound like they are written by Project-GC, but by the community (third person), for example by avoiding all forms of "we have ...". --magma1447 (3305483) (talk) 10:59, 14 December 2021 (CET)
I'm constantly amazed by how fluent you and others are. The English (myself included) are notoriously lazy when it comes to learning other languages, but we expect others to learn ours. I think the best option is to write as best you can, and if necessary I can tweak it so that it sounds more natural. Optimist on the run (6278087) (talk) 12:12, 14 December 2021 (CET)