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

Add user feedback capability to the documentation #468

Open
huijing opened this issue Aug 7, 2024 · 1 comment
Open

Add user feedback capability to the documentation #468

huijing opened this issue Aug 7, 2024 · 1 comment
Labels
website Issues related to the website's functionality, for content updates use the `documentation` tag

Comments

@huijing
Copy link
Collaborator

huijing commented Aug 7, 2024

We are thinking about implementing https://www.feelback.dev/blog/new-astro-starlight-integration/ on the web monetization docs site as a trial to see if it is worth expanding to all our documentation sites.

@melissahenderson
Copy link
Collaborator

I think the Tagged Message Feelback would be the best option. Knowing whether a page was helpful isn't helpful to us if we don't know why. Tagged Message is the type that allows for a sentiment and a message.

Frankly, I like Stripe's messaging. It's straightforward: "Was this page helpful?" and clear: the Yes/No buttons are labeled as such and also have the thumbs up and thumbs down. I don't particularly like using hands in docs because some gestures that are positive in one culture can be negative in another. However, including yes/no makes the meaning clear.

We can work out the details for the feedback screens later.

@huijing huijing added the website Issues related to the website's functionality, for content updates use the `documentation` tag label Aug 20, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
website Issues related to the website's functionality, for content updates use the `documentation` tag
Projects
None yet
Development

No branches or pull requests

2 participants