Difference between revisions of "Talk:Style Guide"

From Project-GC
Jump to: navigation, search
(comment)
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
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?  --[[User:4523550|4523550]] ([[User talk:4523550|talk]]) 22:36, 2 March 2021 (CET)
 
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?  --[[User:4523550|4523550]] ([[User talk: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.). [[User:15789140|15789140]] ([[User talk:15789140|talk]]) 12:08, 4 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.). [[User:15789140|15789140]] ([[User talk: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 [[BadgeGen#Addons|Addons]]" to "Once the user has Ruby or higher they will unlock [[BadgeGen#Addons|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? [[User:6278087|6278087]] ([[User talk: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 ...". --[[User:3305483|3305483]] ([[User talk: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. [[User:6278087|6278087]] ([[User talk:6278087|talk]]) 12:12, 14 December 2021 (CET)
 +
 +
:I started going through all the older pages and changing them from "you" to "the user" since it was said that the third person version was the preferred one. I know I did all in the BadgeGen-category at least and some other category too. But if we've changed our mind on this one I don't see a problem with reverting those changes. :) I know some of the badges sounded "wrong" and needed re-wording but I focused on "the user"-edits at the time. I agree that "Log 5000 finds to achive the diamond badge" is the best wording for the badges, better than both "you" and "the user". --[[User:4523550|4523550]] ([[User talk:4523550|talk]]) 19:30, 15 December 2021 (CET)

Revision as of 19:30, 15 December 2021

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)
I started going through all the older pages and changing them from "you" to "the user" since it was said that the third person version was the preferred one. I know I did all in the BadgeGen-category at least and some other category too. But if we've changed our mind on this one I don't see a problem with reverting those changes. :) I know some of the badges sounded "wrong" and needed re-wording but I focused on "the user"-edits at the time. I agree that "Log 5000 finds to achive the diamond badge" is the best wording for the badges, better than both "you" and "the user". --Pleu (4523550) (talk) 19:30, 15 December 2021 (CET)