60

In Microsoft's documentation for their Bot Framework, the very first link on their support resource list is as follows:

Community support: StackOverflow

Now, it's been established that using Stack Overflow for support like this isn't necessarily inappropriate given certain conditions are met, and to their credit, the Bot Framework team is doing a great job of monitoring the tag and helping to answer questions. However, it's been striking to me recently how large a percentage of questions in the tag are lacking in elements essential for an on-topic Stack Overflow question (a clear and complete problem statement, code to reproduce the issue, an answerable, non-opinion based question, etc.). A few examples are here, here, and here. Likewise, I've seen questions where the template Microsoft provides for new issues on their BotBuilder GitHub issue tracker has been used as the template for a question here, such as here, and here.

Is this a case where someone from Stack Overflow might be able to reach out and help the Bot Framework team better communicate to their users what kinds of questions are appropriate here versus what belongs on a GitHub issue tracker, and try to raise the question quality in this tag?

17
  • 46
    Can we at least get them to put the space in Stack Overflow? Oct 10, 2017 at 13:35
  • 95
    Make a DB script that changes "Microsoft" to "Micro soft" every place it's used on SO untill they do.
    – ivarni
    Oct 10, 2017 at 13:45
  • 17
    Just a quick note that we've seen this, and that we're going to reach out to them. This can sometimes take a while depending on if / how quickly we get a response (especially from huge organizations); we'll start by reaching out to the folks most active in the tag that obviously work there.
    – Tim Post
    Oct 10, 2017 at 13:45
  • Thanks @TimPost! Yeah, it definitely seems like there's a couple specific folks who're most active, so hopefully they'll be responsive.
    – Sam Hanley
    Oct 10, 2017 at 13:51
  • 9
    It is never that obvious to me how a product owner can do what SO (the company) cannot do. There is however another problem with owners helping out: they never moderate content. Also a big problem with Microsoft's support group from Shanghai. They post to any question and never close or vote on one. They get paid to answer questions, not to get rid of them. That wasn't so much of a problem in the olden days, community members usually got to them first. But not anymore, and certainly not in niche tags. A notable achievement of that Shanghai group was killing the MSDN forums btw. Oct 10, 2017 at 13:58
  • 18
    Interestingly, it looks like the references to "StackOverflow" are part of a documentation project which is open-sourced on Github. Someone could hypothetically create a pull request with improved guidance around what should and shouldn't be sent here!
    – Sam Hanley
    Oct 10, 2017 at 18:34
  • 6
    What a positively phrased, open minded, assuming-of-good-intent question. Oct 11, 2017 at 0:40
  • 5
    @SamHanley Hypothetically, if someone did that, it would be nice if they posted the link back here. cough cough
    – svick
    Oct 11, 2017 at 1:07
  • @svick sorry, got pulled away for an emergency work issue shortly after whipping up the changes/PR. Just came back here intending to post it and saw this!
    – Sam Hanley
    Oct 11, 2017 at 2:35
  • And thanks for saying so, @FélixGagnon-Grenier -- I felt bad "complaining" because I genuinely really like/appreciate what Microsoft is doing in terms of community engagement. I just think we can make things better for everyone involved!
    – Sam Hanley
    Oct 11, 2017 at 2:41
  • FYI @SamHanley While we're not a forum, SO does still refer to Q&A chains as "threads". "posts" isn't wrong (and it's probably better), but "threads" didn't need to be changed in your GitHub PR.
    – TylerH
    Oct 11, 2017 at 13:37
  • @TylerH, thanks for the info - is there a source for that usage of "threads"? I wasn't aware of that language being used officially, so I felt it should be avoided so as not to imply notions of being a forum, as you said. This answer seems to indicate that, at least as far as one moderator is concerned, "threads" should not be used.
    – Sam Hanley
    Oct 11, 2017 at 13:43
  • @SamHanley I don't have one off the top of my head; mostly questions, answers, and comments by devs/employees. Which leads me to believe it's probably just a momentary lapse on their part. Either way, "posts" is definitely better, because it helps separate us from the notion that Q&A chains as continuous/linear rather than a one-to-many relationship.
    – TylerH
    Oct 11, 2017 at 13:52
  • 5
    I own the documentation for Bot Framework and I'm happy to effect the change that works out best for our customers and Stack Overflow. I'll approve and merge the PR when it's ready.
    – Robert S.
    Oct 11, 2017 at 16:39
  • The Shanghai members now post comments to vague questions instead of answers. Oct 14, 2017 at 21:37

2 Answers 2

40

I'm Robert. Long-time Stack Overflow user, first-time replier on this thread post. I'm the product manager for Bot Framework and I own the documentation.

I had a somewhat decent reason for linking to Stack Overflow directly – it's where we told customers to go when they had questions about how to build bots – but I think that's a brittle solution. If customers aren't getting answers in the docs and they aren't getting answers here because their questions are bad, then it's a lose-lose situation for them. The change you've proposed in your PR is a good one.

I will also talk with our support team to make sure they give customers the same information.

3
47

As per my discovery that the documentation which links to Stack Overflow is part of an open-source project, I submitted a pull request, contributing basic guidance based on the How To Ask guide in the help center. If merged, hopefully this will simply serve as a preliminary remedy, pending any larger future collaboration between the Stack Overflow & Microsoft folks.

If anyone has feedback on the content, wording, etc. - please feel free to weigh in.

5
  • 4
    You could add space in "StackOverflow -> Stack Overflow", as mentioned above. Oct 11, 2017 at 14:27
  • @VadimKotov, do you see an instance where I didn't correct that? I glanced over it again and don't see that.
    – Sam Hanley
    Oct 11, 2017 at 14:35
  • 4
    Take a look at " contributor-guide/tools-and-setup.md", line 5 Oct 11, 2017 at 14:43
  • Ah, good catch! I'll follow up on that.
    – Sam Hanley
    Oct 11, 2017 at 15:22
  • Pull request merged!
    – RyanZim
    Oct 12, 2017 at 17:59

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .