"Help us build a great library of canonical answers" - Joel Spolsky
This is what it would look like as one of the nav buttons on the main site.
Canonicals
This is the name I submitted using the link from the main question (Warlords of Documentation: Your Quest(ions Answered)).
The reason is that almost every active user on Stack Overflow is aware of what a canonical post is. Yet given that it is a widespread theme there is no special place for those types of posts on the site. Further, there is not even a construct for how to properly make one.
Making a canonical post is very hard and the users who successfully create them tend to be very respected users in those topics with a lot of reputation. I think one of the most famous ones is Felix Kling's ajax post (How do I return the response from an asynchronous call?).
This new "Documentation" feature is in my opinion the perfect place to house a project for canonical posts.
- It has requests which should highlight the need for canonical posts (this in itself is very hard to identify today)
- It will be a place to search for canonical posts only as opposed to finding them intermingled in "the wild" (SO main)
- It will provide a construct for creating examples that many users can share in cultivating and maintaining
- It will separate content in a meaningful way making it both easier to find and create
- It will solve the issue of trying to name a canonical post to be something that google finds
- Using the canonical guidelines which already exist to some degree in the community will give a stronger direction for the type of content being created
- It will remove the disparity between taking over simple MSDN (or related vendor documentation) property names and descriptions and drive the creation of content related to using those properties while still retaining the ability to link to actual vendor documentation
- When there is a void of actual vendor documentation, a canonical post is best suited to not only avoid stepping on the toes of the vendor but also to creating a place where people can expect to see some examples with rigor that are accepted by the community
Documentation is simply not what the project is. Documentation often includes small snippets but the community here on Stack Overflow has far more rigor than the average vendor. As a community, we will create fully scrubbed content in this place and it deserves to be akin to a description such as "according to or ordered by canon law" more than something which resembles a stack of paper or a 3-ring binder.
Stack Overflow is not meant to be a library of reference manuals. It's supposed to contain the same information as a library of reference manuals, in the form of millions of questions and answers. Combined with Google, that gives us the magical power of a library of reference manuals you never have to read! It's like, you got to the library, and there's a wizard there at the door, and you ask your question, and, instead of being told to read a book, you just got (are you sitting down?) the actual answer! - Joel SpolskyJoel Spolsky