Closed Hans5958 closed 2 years ago
I'm currently using Giscus on my website and it's really nice, but I don't know whether comments go well with docs?
I'm currently using Giscus on my website and it's really nice, but I don't know whether comments go well with docs?
Well, I got the idea from Haxe's docs, which I found from utteranc.es. An example is https://haxe.org/manual/introduction-hello-world.html.
I will continue on this when we got blog merged.
My plan is to use Giscus since I think it is mature enough to be sustainable. (They got sponsor, you know?)
@WorldLanguages Say that I add giscus to our website, would that need significant changes on the privacy policy? (Just an addition of the list of third-party services is not significant)
@Hans5958 I think it would be fine
Here are the screenshots until this day. The "code of conduct" link will be linked to the copy on the website. Please tell me whether I need to turn off comments on select pages. If there are no objections then I can start set up Giscus on this repo, some days later.
@Hans5958 How can we moderate those comments?
@ Hans5958 How can we moderate those comments?
We can use the same thing we use to show Scratch comment warnings
@WorldLanguages I think it's just like what you do on GitHub Discussions, you can remove messages, lock discussion, etc.
EDIT: Yeah, it is mentioned on the website.
How it works
When giscus loads, the GitHub Discussions search API is used to find the Discussion associated with the page based on a chosen mapping (URL, pathname,
, etc.). If a matching discussion cannot be found, the giscus bot will automatically create a discussion the first time someone leaves a comment or reaction. To comment, visitors must authorize the giscus app to post on their behalf using the GitHub OAuth flow. Alternatively, visitors can comment on the GitHub Discussion directly. You can moderate the comments on GitHub.
Sounds good enough, since all comments end up on GitHub too
I have an idea to add a comment section for the documentation (and the blog in the future).
I have two services in mind to use. Both using GitHub.