Just a small thank you for moving the comments as you have. I kind of expected to see 'give documentation feedback' take me to GitHub. It's not overly clear from the UI, how I follow up on any comments I make (but I found it nevertheless!).
A small point but a great move forward!
When will the rest of the docs be like this???
⚠Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
@ghogen can you comment on if/when the rest of the docs will have the same feedback mechanism?
@EisenbergEffect for the feedback about the UI.
This is a pilot program on VS, but we expect to refine the mechanism based on feedback and roll it out across the docs.microsoft.com site by the end of March.
Hey @doctordns Thanks for the feedback. As @ghogen states, we're basically piloting this new experience on just a couple of repos now so that we can iron out the kinks, get some customer feedback and make minor improvements/enhancements before we roll it out more broadly. Assuming the pilot does go well, we'll absolutely be making this the new feedback mechanism across all of docs. We'll be putting ongoing effort into the evolution of this feature as we get feedback from people like you and others, so that we can refine the UI/UX and make this a great experience for you and Microsoft employees to engage.
@EisenbergEffect - this is great news. I look forward to the updated feedback mechanism scaling to ALL the documentation. :-)
One thing that might be good to get sorted out is how contributors are noted on the docs.microsoft.com site. Some doc repos have icons on the docs.microsoft.com pages, others do not. Consistency would be useful (preferably with all documentation showing contributors).
@doctordns I've noticed some of these inconsistencies. There may be a few different causes. Can you link me to a few examples where you are not seeing the contributors listed? I'd like to investigate.
As much I like the new system idea, I hate the fact that this is happening over and over.
It used to be a Disqus comment system, then moved to LiveFyre, then moved now to this new system, what will be the next?
The worst part of this all is that MS does not care about past content lost on these discussions, so many times I found issues described in the docs that are gone now.
Please, pay attention to your previous mistakes, don't let the information be lost again, at lest import them as closed issue in the new system.
The 'content source' link point to the wrong location, shouldn't it point to here
I have some sympathy with comments by @guibirow. But having said that, I think converging on GitHub for both comments (ie issues) and the code (ie solutions) should be in the same place.
In my experience, the idea that MS does not care about past content is just not true. I do agree that some comments, etc were left out with the move from msdn/technet to docs.microsoft.com. The costs of trying to bring those across sensibly is likely enormous - have you seen just how much junk there is in old comments?
Sure, there were a lot of junk. But in the middle of the junk we could find some valuable information not contained in the docs.
The migration from there to github won't cease the spam, because something that lacks is moderation, so the junk will just have a new the location.
@guibirow thanks for your feedback. We have seen a decrease in "junk" comments since moving to the GitHub issues system. Also, we have all the old LiveFyre comments stored in a database and, time allowing, we plan to address the most important concerns expressed there.
Also, you commented that content source should be linking to the visualstudio-docs repo instead of the visualstudio-docs-pr repo. @EisenbergEffect can you comment on that?
@ShevaDas Can you follow up with @jdanyow about the GitHub issues content linking? This involves the scenario where there is a public/private repo pair and the content link is pointing to the private repo rather than the public repo.
@EisenbergEffect, @ShevaDas - I'm working on an update to correct the content linking. Thanks for the heads up :+1:
@EisenbergEffect, @ShevaDas - the fix for the content linking has shipped. :ship: :shipit: :rocket:
Great work @jdanyow ! Thank you!
@guibirow thank you for pointing out the bug. @jdanyow thank you for fixing it!
Most helpful comment
Hey @doctordns Thanks for the feedback. As @ghogen states, we're basically piloting this new experience on just a couple of repos now so that we can iron out the kinks, get some customer feedback and make minor improvements/enhancements before we roll it out more broadly. Assuming the pilot does go well, we'll absolutely be making this the new feedback mechanism across all of docs. We'll be putting ongoing effort into the evolution of this feature as we get feedback from people like you and others, so that we can refine the UI/UX and make this a great experience for you and Microsoft employees to engage.