Skip to main content

Timeline for Documentation Update, August 4th

Current License: CC BY-SA 3.0

16 events
when toggle format what by license comment
Mar 20, 2017 at 9:34 history edited CommunityBot
replaced http://meta.stackoverflow.com/ with https://meta.stackoverflow.com/
Aug 6, 2016 at 13:56 comment added Cody Gray Mod No one "browsed" MSDN after installing it from CD, either. Even back in 1999, the big important feature of WinHelp was built-in full-text search.
Aug 6, 2016 at 1:50 comment added Cimbali @JörgWMittag Right, I'm not very active on documentation. I meant here, on meta. Everyone seems concerned about how we get better content, which is great. Or more often, trying to figure out what content we want or how it should be formatted. I don't think we can hope to find the good way of doing things before actually starting to use Documentation.
Aug 6, 2016 at 0:41 comment added Adam Lear StaffMod @JGreenwell "Google" is effectively synonymous with "search" at this point. :) Either way - we'll be putting more work into search in Documentation.
Aug 6, 2016 at 0:39 comment added LinkBerest - SO sold our work @AdamLear I read it as "Use Google" - the browsing experience is a separate issue (and definitely an issue)
Aug 6, 2016 at 0:32 comment added Adam Lear StaffMod @JGreenwell Eh... I can't speak for Shog, but that reads to me like "we care about search, not browsing experience". Google, site search, (if you really must) Bing, etc are all potentially an option.
Aug 6, 2016 at 0:30 comment added Jörg W Mittag "I feel like everybody is trying to fill documentation with good content" – You must look at different tags than I do. Ruby is abysmal, IMO. I am so overwhelmed, I don't even know where to start. stackoverflow.com/documentation/ruby/3464/comments Really?!?
Aug 6, 2016 at 0:28 comment added Jörg W Mittag @Frank: the problem with outsourcing search to Google is that Google is search for English, but Stack Overflow is Programmerese, not English. In Programmerese, -> is a word, not punctuation, and and is not a stop-word. But I already argued this (and was shot down) "6-8 years ago"™ during the private beta when Meta was still UserVoice, so I'm not holding my breath until search gets fixed.
Aug 6, 2016 at 0:03 comment added LinkBerest - SO sold our work @AdamLear Per Shog9: so you just mentioned that you don't really browse MDN. Same here. Google or links from other topics (that I find via Google). Browsing is for when you're stuck in 1999 and have just installed MSDN from CD. on SOD chat - as one example of where Frank and others are getting the "we don't care about anything besides Google search"
Aug 5, 2016 at 23:37 comment added Frank @Cimbali I upvoted your question long ago and think your ideas there are good and reasonable. What I was trying (very poorly) to get at -- more than how much SO cares about search results, topic ordering and other internal navigation -- was that you characterize internal search as helping "people who want to use" docs, while the refrain I have been hearing is that all such people will arrive from external search...
Aug 5, 2016 at 23:04 comment added Cimbali @Frank Plus I only suggested very trivial things (that would imho make a big difference already). But I also really think that we won't be definitively sure of what Documentation really should be until people start actively using it.
Aug 5, 2016 at 21:37 comment added Frank @Adam Okay, that's good to hear.
Aug 5, 2016 at 21:36 comment added Adam Lear StaffMod @Frank I'm not sure where you heard that for Docs, but that's incorrect. We do expect most readers to come from Google, but the current state of search in Documentation is pretty bad (not even on par with Q&A for usefulness) and we'll be putting more work into it once other, more pressing issues are resolved.
Aug 5, 2016 at 21:30 comment added Frank Regarding rules, I really don't think we need more rules, per se. Wikipedia is entirely consumed by its rules and the bureaucracy and thousands of fiefdoms that come with it. Right now, we need to arrive at a vision for what Docs can be used for... after that, we'll know if we need rules to enforce that vision that go beyond the mechanics for editing, review and rep.
Aug 5, 2016 at 21:27 comment added Frank Regarding search (your link), SO staff have said every time that they won't put much energy towards it because they can piggyback on real search engines (like google) and expect most visitors to arrive that way. Internal search is pretty much just for us editors, not visitors.
Aug 5, 2016 at 21:17 history answered Cimbali CC BY-SA 3.0