-
-
Notifications
You must be signed in to change notification settings - Fork 32.5k
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
[docs] Add page feedback #22885
[docs] Add page feedback #22885
Conversation
This comment has been minimized.
This comment has been minimized.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is great. Really looking forward to the feedback.
About the infra: Why is docs/rating
not included in the workspaces? By including it we wouldn't need the extra install command.
About the actual UI: Since this includes quite some code, needs interactivity we and is located at the bottom we probably want to lazy load it. That way we can have a dedicated component (MarkDownDocs is quite big) and don't add that much to the initial bundle size.
This comment has been minimized.
This comment has been minimized.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
A couple of thoughts:
- If we include the version, we could also include the language too in the feedback record.
- I have a few doubts about DynamoDB as the best database for our problem. DynamoDB does not provide aggregation functions. So if we want to compute the global mean for all the pages, compare the rating for each version, for each language, for different quarters, etc. We won't be able to do it easily. It seems that we would need to go into the ETL land, load the data in a Redshift, or in Athena, etc. Not as simple as running a SQL AVG() aggregation function.
- I wonder about the precision of:
rating = (average * count + request.body.rating) / (count + 1);
once you get >1,000 feedback.
2ec33b4
to
1df3b19
Compare
Page feedback
Preview
UI
Feedback
Submit notification