Skip to main content

Timeline for Naming the Documentation Feature

Current License: CC BY-SA 3.0

21 events
when toggle format what by license comment
Jan 18, 2021 at 12:03 history edited CommunityBot
replaced http://blog.stackoverflow.com with https://blog.stackoverflow.com
Jun 3, 2020 at 15:29 history edited CommunityBot
Commonmark migration
May 23, 2017 at 12:38 history edited CommunityBot
replaced http://stackoverflow.com/ with https://stackoverflow.com/
Mar 20, 2017 at 9:15 history edited CommunityBot
replaced http://meta.stackoverflow.com/ with https://meta.stackoverflow.com/
Aug 12, 2016 at 17:13 comment added Wayne Werner Us Python folks already collect canonical question/answers. It seems like it has a pretty huge overlap with SOD
Mar 25, 2016 at 17:02 comment added Shelvacu Reading through all the suggestions, this is still my favorite. It hints at what it is, and for lack of a better description, just feels like a nice word.
Jan 16, 2016 at 3:47 comment added Damian Yerrick Canonical is the company behind Ubuntu, and we already have a Stack Exchange site about that distro.
Sep 23, 2015 at 18:56 history edited Travis J CC BY-SA 3.0
added 688 characters in body
Sep 23, 2015 at 2:55 comment added Travis J Read about it from Joel Spolsky blog.stackoverflow.com/2011/01/… . Have you heard of him?
Sep 22, 2015 at 12:07 comment added Vlastimil Ovčáčík I haven't heard of canonical answer before reading this post.
Sep 21, 2015 at 23:51 history edited Travis J CC BY-SA 3.0
added 194 characters in body
Sep 19, 2015 at 20:40 comment added duplode @TravisJ ... however, unfolding the argument in this way makes your idea appear even more clever than it did at first, and so I will upvote it anyway :)
Sep 19, 2015 at 20:38 comment added duplode @TravisJ I get that you are using "canonical" with the meaning it has within Stack Overflow, and in that sense "a place for canonical Q&As" is a great description of the project. What I mean is that the name you proposed is also subtly subversive. "Canonical" implies "backed by authority" (e.g. ecclesiastical authority behind canon law). Your suggestion suggests a shift of authority from vendors to the community at large, and that is why I sensed a tension between it and my own concerns...
Sep 19, 2015 at 4:59 comment added Travis J @duplode - We already have canonical posts here. They are not vendor documentation. In fact, the whole point of this naming convention is a departure from the idea of documenting, which would be in line with your concern about avoiding "user-submitted content as documentation." User submitted content would not be documentation, it would be a set of canonical posts requested by the community and actioned by the community. This would yield the benefit of aiming more towards the classical approach to examples and solutions that Stack Overflow excels at, and away from mimicking documentation.
Sep 19, 2015 at 4:11 comment added duplode +0. This is a very good idea in many ways, but given that my main concerns with the proposal had to do with canonicity (in a different sense) I unfortunately can't subscribe to it.
Sep 18, 2015 at 22:48 comment added natario Regardless of its meaning, a broad word is broad for search engines too. Querying Map<K,V> Documentation on google nearly makes no sense, and one would end up appending SO, like Map Documentation StackOverflow, or ending in another website, for the first months at least. Map<K,V> Canonicals, on the other hand, looks focused, unused, and would definitely point you here.
Sep 18, 2015 at 21:25 comment added Travis J @zzzzBov - The word is very broad, "a set of documents". So sure, it can be anything and include everything written. I am technically creating a documentation of my point right now. As a result, it is so broad that there is no actual definition aside from what the current status quo of documentation is - a place where there is a bland list of properties and fields, perhaps some remarks, and if you are lucky an example or two. Using the name documentation gives the guidance to reproduce that. The guidance should be narrowed to something more inline with what the community should produce.
Sep 18, 2015 at 21:21 comment added zzzzBov I hope to cut this debate short by saying that my definition of "documentation" is broad enough to encompass everything I've been hearing about with the coming changes, in the same way that my definition of "Q&A" is broad enough to include Stack Overflow, where many would argue that it is so much more than Q&A. I'm not saying that the name should be "Documentation", I'm just saying that it meets my definition of the word.
Sep 18, 2015 at 21:17 comment added Travis J @zzzzBov - The goal to make documentation better by doing documentation the exact same way everyone else does (clear correlation to MSDN styling being used) and then calling it the same exact name everyone else calls it does not necessarily lend itself to improvement. That would simply be a relocation. Relocation does not accomplish the goal of the project. In order to improve the ability to use vendor code, a place for the community to create not only examples but the set of exposed features is very important. That to me is not simply documentation. It is a set of canonical posts.
Sep 18, 2015 at 21:08 comment added zzzzBov "Documentation is simply not what the project is" - I haven't seen anything that says the project is going to do more than be documentation. Examples are documentation. Samples are documentation. API details are documentation. I think the difference with this project is the focus on quality at scale. It seems to me that the plan is to (1) make more documentation (2) better. This is A Good Thing™ IMO.
Sep 18, 2015 at 20:52 history answered Travis J CC BY-SA 3.0