last day (24 days later) » 

5:14 PM
Hello Tsyvarev! I hope you are doing well.

Recently, I made a data.stackexchange.com query to find links to older version of CMake docs in answers: https://data.stackexchange.com/stackoverflow/query/1638993/links-to-old-cmake-docs-in-answers

I know that the old docs already have a warning banner about this that links to the latest version of the docs, but I'm wondering if it's a good idea to update any of them to always point to the latest version of the docs.

con: The doc page might be removed or moved in a later version of CMake, so pointing to the latest version of the docs could caus
When you link to the CMake docs, how often do you point to the latest version compared to a pinned current/older version?
 
5:38 PM
room topic changed to Links to old versions of CMake docs: Should any links to older versions of the CMake docs be updated? [cmake] [documentation]
Note: I was originally going to make one-on-one chats with a couple of people who frequent the cmake tag, but I've changed my mind and will now just invite them to this chat.
 
I don't think the answer is clear-cut. Which set of docs to link to depends on the content of the question/answer. If an answer is addressing one specific version or multiple versions, a moving target isn't appropriate. If an answer is giving general advice absent a version constraint, linking to the latest documentation makes more sense (imo).
I think that I mostly link to the latest docs
 
That makes sense. I think I've linked to a pinned version of docs _once_. I'll go digging for that instance.

Is there anyone else you think I should invite to this chat?
 
I'm not sure why I was invited to this chat (I'm not even a gold badge), honestly, so I'm not the right person to ask
 
5:54 PM
I added you because I wanted to know what you thought :) simple as that. And thank you for sharing what you think!
If I wrote my query correctly, Alex has 3 answer linking to pinned doc versions (1, 2, 3), and 117 linking to the latest docs.
 
When I begun to answer CMake question on Stack Overflow, I tended to leave links to documentation of specific CMake version, thinking that in the newer versions the answer may loose its correctness. E.g. this is one of my first's answers. The documentation of specific version was even in my browser's bookmarks. (I am not sure, but that years CMake has no "always-latest" link to the documentation).
But some years later I decided to put links to the latest documentation. In many cases I cited documentation for specific paragraph, so I don't fear that the answer losts its sense in newer CMake versions.
As for updating links to older CMake versions in existing questions, I don't think that we should do that unless the target for the link is actually lost. Even If CMake developers decide to drop documentation for some old version, I am pretty sure they redirect all references to it to some new pages. So lifetime of the link, say, cmake.org/cmake/help/v3.0/command/execute_process.html will be the same as for cmake.org/cmake/help/latest/command/execute_process.html.
 
6:24 PM
I see. Thanks for sharing your thoughts and time!
 

  last day (24 days later) »