7

Context

There are currently 2 main tags about Microsoft Bot Framework:

  • which was the main tag for all question for more than a year, as the v3 of the framework was stable
  • which has been created to post questions specific to this v4 version, where the architecture has been really changed (so questions were often not linked to v3 anymore)

Microsoft Bot Framework in version 4 is officially stable for a few days (see here).

Evolution?

I'm wondering if we should:

Why?

I'm one of the top repliers of and I see many people using this "now old" tag for v4 related questions, so there are many question wrongly tagged. I would like to discuss about which scenario would be the best one, between putting everything in the same place (I'm sure there will be questions related to v3 for a few months) or splitting with the tags.


Edit 23/10 - Details about what has been done

On the 22nd of October, no replies have been provided to this question, only a few comments from @Braiam. So I made the changes to modify questions with to .

Following this, a discussion has started on this topic, including people from Microsoft who work on Bot Framework. This ended by keeping the modifications of the tag to get only one , and @Braiam made a PR on Microsoft Github's repo to avoid pointing to .

Finally, for future questions like that, it may be important to suggest people to duplicate (or link) their question to what is now the "parent" Github repository, https://github.com/Microsoft/BotBuilder ?

4
  • There are only 37 questions and you have 2k. You can simply retag all the -v4 question to the non-suffixed tag.
    – Braiam
    Oct 5, 2018 at 14:45
  • That's the 2nd proposition yes. But merging everything inside 1 tag can be subject to discussion, hence this topic
    – Nicolas R
    Oct 5, 2018 at 14:47
  • I'm suggesting that as the easier solution that can be done right now without intervention of a moderator. Merging and retagging are the same thing for all purposes, so you are discussing whenever or not should you make a moderator do it for you.
    – Braiam
    Oct 5, 2018 at 14:50
  • @NicolasR Thank you for raising this. We are having some internal discussion on the Bot Framework Support team about this. Historically, how are tag versions handled in other cases on Stack Overflow? Oct 22, 2018 at 20:49

2 Answers 2

6

My preference is the "one tag" model. When we introduced the "-v4" tag, I don't think anyone really thought about the friction this could cause, or how the support matrix would continue to become increasingly complex over time. For example:

  • As we approach "4.1" later this month, should we consider a "-4.1" tag?
  • Should there be a "-v4-java" tag?
  • Should we introduce a "-tools" tag?
  • [...]

The answer is clearly no as it would quickly become unsupportable.

The Link in our C# Readme, was added simply as I have an addiction to GitHub Badges.

Braiam has graciously already submitted a PR to remove this tag from the branch and that PR has been merged.

3
  • Note - I should add, I mange the BotBuilder repos, as well as our team of support engineers. Sometimes I'm even able to find the time to write code. :)
    – Chris M.
    Oct 23, 2018 at 0:00
  • Chris, ★Nicolas R ★, the one who opened this, is the one Jason and I were telling you about a few months back. He contributes to our GitHub repos as well. SUPER helpful! Should be MVP!!! :) Oct 23, 2018 at 0:06
  • Thanks ChrisM. for this clear reply, I'm in line with your opinion. The v4 was here to avoid mixing questions during the beta period, now it's over. Thanks @Braiam for the PR
    – Nicolas R
    Oct 23, 2018 at 11:48
3

If action is being taken to straighten out the usage of these tags, it needs to involve coordination with Microsoft. Microsoft is notable in terms of third-party players in terms of how many places they link to specific Stack Overflow tags. In this case, they link to the (now soon-to-be-deleted) tag in the readme.md of the Bot Builder SDK v4 Github repo.

At the very least, we should make sure that MS is aware of any changes being made to these tags, and arguably, they should be able to weigh in on what lines to draw between the different tag versions. Arbitrary changes to which tag is being used for which version are likely to cause deprecation of a lot of other links, especially if you propose moving v3 questions off of the tag (which seems like a required next step if you're attempting to repurpose that tag to refer to v4).

There's precedent for collaborating on this, as we have engaged them in the past regarding efforts to clean up the question quality in the Bot Framework tag, to good results.

4
  • 1
    I understand your points, that's also why I posted this question initially but my main problem was: how should we ask them? I also think that these tags must be managed by the community (By the way it's not Microsoft people who created this v4).
    – Nicolas R
    Oct 22, 2018 at 15:19
  • You could ask them by contacting the Stack Overflow user who answered the prior post I linked, who identified himself as being the the product manager for Bot Framework and owner of the documentation. Or you could open an issue on the Github repos for any of their documentation which you've broken by unilaterally deleting this tag - I linked you to at least one such instance. But deciding to "manage" these tags without care for breaking existing links is harmful.
    – Sam Hanley
    Oct 22, 2018 at 15:32
  • 1
    This man never contributed so either botframework or botframework-v4. This tag management "without care" has been made to help people asking question to get proper replies, because it was just a mess as people did not follow the documentation you mention and are posting in either one tag or the other. By the way I also have made an edit to the tag description to ensure that the information are correct (fixed linked that Microsoft also broke on their side...) so my contribution was not made to break everything as you mentioned, sorry
    – Nicolas R
    Oct 22, 2018 at 15:56
  • I didn't intend to start a dramatic confrontation - I certainly don't think it was your intention to "break everything". I'm only trying to draw attention to information that I felt needed to be taken into consideration. I really didn't expect such a defensive reaction given that the point of this question was to solicit community input on a potential change, and I'm sorry if any of my response pushed this to be unnecessarily contentious. As someone who has both asked and answered questions in the botframework tag, I assure you I share your goal of improving these tags.
    – Sam Hanley
    Oct 22, 2018 at 17:19

You must log in to answer this question.

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