« first day    last day (23 days later) » 

12:15 AM
I've invited vre to this chat. It looks like vre has 13 answers linking to pinned doc versions and 16 to the rolling latest doc version.

vre if you're okay with sharing your thoughts on this I'd appreciate it!
 
12:51 AM
I've invited usr1234567 to this chat (45 answers linking to pinned doc versions between 2014-2019, and 17 answer linking to rolling latest version between 2015-2021).

usr1234567 if you're okay with sharing your thoughts on this I'd appreciate it!
 
1:14 AM
I've invited Fraser to this chat (208 answers linking to pinned doc versions between 2012-2015, and 5 answers linking to the rolling latest version between 2012-2013). If you have thoughts you'd like to share, please do!
I want to make sure I say that I'm here to listen to and to try to learn from those who have much more experience than me. If I come off as awfully naive or foolish, it's because- to some degree- that's true, so I ask that you be patient and understanding with me.
I've invited sakra (26 answers linking to pinned doc versions between 2011-2016, and 75 linking to the rolling latest version between 2011-2021). If you have thoughts you'd like to share, please do!
I've invited arrowd to this chat (33 answers linking to pinned doc version between 2011-2016, and 28 linking to the rolling latest version between 2011-2021). If you have thoughts you'd like to share, please do!
room topic changed to Links to old versions of CMake docs: How do you choose whether to link to a specific version of the docs vs. the always-latest version? Should any links to older versions of the CMake docs be updated? [cmake] [documentation]
I've invited Florian to this chat (83 answers linking to pinned doc versions between 2015-2018, and 117 answers linking to the rolling latest version between 2015-2018). If you have thoughts you'd like to share, please do!
I've invited ComicSansMS to this chat (168 answers linking to pinned doc versions between 2012-2020, and 29 answers linking to the rolling latest version between 2013-2022). If you have thoughts you'd like to share, please do!
I've invited kevin (squareskittles) to this chat (73 answers linking to pinned doc version between 2019-2021, and 244 answers linking to the rolling latest version between 2019-2021). If you have thoughts you'd like to share, please do!
I've invited Craig Scott to this chat (4 answers linking to pinned doc version between 2015-2016, and 42 answer linking to the rolling latest version between 2015-2019).

Craig, I'm particularly interested to hear from you since you're one of the maintainers of CMake.
 
 
4 hours later…
5:28 AM
@davidfong I think we should always prefer the rolling latest version. A couple of releases ago, this did not exist. Now I always try to pick the rolling latest. There you get the latest and greatest. The only exception for me would be, to point out an old behaviour.
 
5:48 AM
@usr1234567 Thanks for your response. In what cases would you think it would be appropriate to update an old answer to point to the latest docs?
 
6:10 AM
Updating should be fine or without any downside in 99% of the cases. But I don't think it is worth the effort.
 
vre
6:45 AM
@davidfong I try to link always to the latest version of the documentation except in cases where the behaviour was only documented or has changed in a specific version or the OP asks about a specific version. From the latest version of the documentation it is easy to compare the docs with earlier versions by using the drop down box in the upper left corner. You'll be shown the same documentation page currently displayed of the specific version as long as the structure of the docs does not change.
 
 
4 hours later…
11:05 AM
I also link latest these days in answers, unless the answer talks about version-specific behavior (which almost never happens, as CMake has pretty strong backwards compatibility).
Sometimes when I get back to an old answer that still links to the pre-3.0 style documentation, I do update the link, as the docs were structured completely different back in those days (and significantly harder to read imho). But most of those answers are too outdated now to get much attention anymore. So I don't feel that updating all of them systematically is going to be worth the effort.
 
 
2 hours later…
1:36 PM
Agree with the other answerers here - I'll typically link to the latest docs, unless question is specific to an old or modified CMake behavior. Folks are pretty good about updating old/dead links when necessary, so I wouldn't try to do them all yourself... unless you're badge hunting! :)
 
 
8 hours later…
9:29 PM
I too try to link to the latest these days. My experiences mirror those of others already noted above. In general, we do try to preserve links in the docs now. If the docs are updated, we aim to keep anchors even if the headers or sections they refer to are reworked or renamed. This isn't always possible, but exceptions are rare. I think it is more valuable to point people to the latest information and accept the small risk that the link might not exist at some point in the future.
I should also add that there was an effort a few years ago to make older versions of the docs point to the latest version as the canonical page. This was an attempt to make the latest versions show up higher in search results instead of older ones due to people linking more to older pages.
My gut feeling is that the results are tending to point more to the latest docs now, but could be my custom search results bias. I mainly mention this because more links to the latest in SO probably means more latest links showing up in search results too.
 

« first day    last day (23 days later) »