search

osism / osism.github.io

OSISM documentation
https://osism.github.io
Creative Commons Attribution 4.0 International
0 stars 7 forks source link

Allow comments in Docusaurus with Giscus and GitHub Discussion #294

Open Nils98Ar opened 8 months ago

Nils98Ar commented 8 months ago

Allow visitors to leave comments below articles for low-threshold feedback and improvement suggestions.

See: https://dev.to/m19v/how-to-add-giscus-comments-to-docusaurus-439h

Nils98Ar commented 8 months ago

It would be ideal to create one discussion per article as soon as the first comment is created in my opinion.

berendt commented 8 months ago

What is the added value compared to issues?

Nils98Ar commented 8 months ago

That it is directly available in Docusaurus and you can start writing directly below the article.

I think many people would not go to GitHub and open an issue but maybe they would leave a comment below the article which could be turned into an issue.

berendt commented 8 months ago

Take it with you to the SCS Call on Wednesday. This then needs to be moderated etc. I think there are enough ways to ask and we don't need to add another way.

Nils98Ar commented 8 months ago

My idea was to make it as easy as possible to keep the docs up-to-date and this way it would be at least integrated into GitHub and compatible with issues etc.

berendt commented 8 months ago

Feel free to discuss it on Wednesday. I don't see much benefit in it. The more channels are open, the more effort it takes to monitor everything and respond in a meaningful way.

Nils98Ar commented 8 months ago

Okay, but to make it clear: I thought about feedback and improvement suggestions and not about support questions ;)

Nils98Ar commented 8 months ago

Maybe an „Open issue“ button would be better then.