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 |