Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Multiple issues for same page (threads) #39

Open
abernix opened this issue Jun 12, 2018 · 6 comments
Open

Multiple issues for same page (threads) #39

abernix opened this issue Jun 12, 2018 · 6 comments

Comments

@abernix
Copy link

abernix commented Jun 12, 2018

I really love the GitHub-powered feedback integration on docs.microsoft.com which allows multiple issues (each with their own comments) to be attached to a single content page, rather than just individual comments on a single issue.

This sort of organization works particularly well for documentation sites since issues can be addressed and then removed from the default view and allowing those responsible for the documentation to ensure they've responded to each request! It's even more valuable when the content itself lives on GitHub since issues that resolve the problems can be linked directly to the commits which resolve them!

It seems that Utterances is the open-source version of the Microsoft docs commenting implementation, but currently lacks the additional dimension (unless I'm missing something).

I'm curious if this is on the roadmap for utterances!

@nschonni
Copy link
Contributor

Just cross referencing this related issue MicrosoftDocs/feedback#396

@jdanyow
Copy link
Member

jdanyow commented Jun 14, 2018

@abernix it wasn't on the roadmap for utterances.... I guess it should be. You're the second person to mention this! I believe @nschonni was the first. Utterances was developed to be a blog post commenting widget. I didn't anticipate folks would want the documentation issue tracking mode that we developed for Microsoft docs.

@nschonni
Copy link
Contributor

"If you build it, they will come"

@jdanyow jdanyow mentioned this issue Jun 28, 2018
@scottdorman
Copy link

@jdanyow The mode used on Microsoft Docs doesn't necessarily work well for a blog commenting system, but it does work really well if we're building an equivalent system to Docs for our own projects. For example, a Docs style (based?) site for documentation of an open source library/framework. A perfect example that comes to mind would be the documentation for Json.NET being rewritten in a style like Docs and being able to provide the same type of GitHub issues integration.

That being said, I don't see why that mode wouldn't also be useful for a blog as well. It just depends on what the blog author is aiming for when it comes to being able to leave comments.

@jdanyow jdanyow changed the title Multiple issues for same page Multiple issues for same page (threads) Jan 19, 2020
@carlo-quinonez
Copy link

carlo-quinonez commented Feb 13, 2020

Any update on releasing the documentation issue tracking used on the Microsoft Docs sites? I'd like to do the same for our documentation.

@adamist521
Copy link

Would be really awesome to have it too here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

6 participants