docs icon indicating copy to clipboard operation
docs copied to clipboard

Giscus comments

Open bravo-kernel opened this issue 3 years ago • 5 comments

Checklist

  • [X] Issue has a meaningful title
  • [X] I have searched the existing issues. See issues

Summary of the request

We could consider adding Giscus comments (built on Github discussions) for pages:

  • Matches our audience
  • Upvotes, reactions, etc.
  • Easily moderated via github interface
  • Could lead to more interaction

Additional info:

  • https://github.com/giscus/giscus (make sure to open the https://gisqus.app)
  • https://m19v.github.io/blog/how-to-add-giscus-to-docusaurus

Try it out here https://www.bravo-kernel.com/blog/2020/01/creating-a-scheduled-broken-links-checker-using-github-actions

Suggested section

None

bravo-kernel avatar Jan 30 '23 18:01 bravo-kernel

Looks like a cool solution. Comments is a bit uncommon for docs-sites though, isn't it?

Off-topic: In your example, why does it look like you're talking to yourself? You mention someone else, but only your posts :)

fflaten avatar Jan 31 '23 17:01 fflaten

I agree that it is a bit uncommon but I can imagine it making the hurdle to comment, ask, etc. much lower.

The reason you are seeing me talking to myself (online and in real-life now) is... that those comments were imported from Disqus (hover on a username).

bravo-kernel avatar Jan 31 '23 17:01 bravo-kernel

Upvote on this, azdo has comments for wiki and it is very useful when the page becomes outdated and people post tips on how to actually do the thing the page describes.

nohwnd avatar May 02 '23 13:05 nohwnd

Sounds great 👍 @bravo-kernel still working good on your blog. No issues after the theme-fix? Removing spam etc also works fine?

Usually I'd say GitHub-only would limit a comment-solution, but as it's already required to make a docs-issue it's fine.

fflaten avatar May 02 '23 15:05 fflaten

No issues at all and even though spam is non-existent, annoying responses can always be deleted in Github Discussions.

bravo-kernel avatar May 02 '23 18:05 bravo-kernel