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

fix: Feedback instructions and reminders (Short term solution for issue #569) #570

Open
wants to merge 3 commits into
base: master
Choose a base branch
from

Conversation

contraexemplo
Copy link
Member

@contraexemplo contraexemplo commented Mar 18, 2024

This is my proposed short term solution for issue #569. Feedback 4, our final feedback cycle, is referred to as final feedback in code. When mentors are late to submit Feedback 4, we send them an automated email via organizer dashboard that includes wording about their intern's final stipend payment — but that doesn't reflect current Outreachy policies. I've updated this file to include the same wording used on home/templates/home/email/feedback4-feedback-reminder.txt.

Feedback 4, our final feedback cycle, is referred to as "final feedback" in code. When mentors are late to submit feedback about their interns a fourth time, we send them an automated email via organizer dashboard that includes wording about their intern's final stipend payment — but that doesn't reflect current Outreachy policies. I've updated this file to include the same wording used on `home/templates/home/email/feedback4-feedback-reminder.txt`.

Feedback 4 is still referred to as `final_feedback` in code. We probably shouldn't use `feedback4` yet.
Since our code uses both `final-feedback-instructions.txt` and `final-feedback-reminder.txt` as the templates for automated emails, it doesn't make sense to keep redundant files.
@contraexemplo
Copy link
Member Author

Sage Sharp and I discussed #569 today. We agreed to remove the unused, redundant files feedback4-feedback-instructions.txt and feedback4-feedback-reminder.txt from our repository. Files final-feedback-instructions.txt and final-feedback-reminder.txt will be a part of a bigger code refactoring effort in the future.

If you're interested in the bigger context around this issue, I published a longer, more detailed report about it on my blog.

@contraexemplo contraexemplo marked this pull request as draft April 4, 2024 00:04
@contraexemplo
Copy link
Member Author

Marked as a draft as I found a couple more issues with our feedback instructions and reminder email templates. Will add more details to #569.

@contraexemplo contraexemplo changed the title fix: late Feedback 4 reminder (short term solution for issue #569) fix: Feedback instructions and reminders (Short term solution for issue #569) Apr 4, 2024
@contraexemplo contraexemplo marked this pull request as ready for review April 4, 2024 13:45
Upon further inspection, all feedback instructions and reminders were quite inconsistent in the way they informed mentors about our current policies and in the terminology they used to refer to feedback cycles. My proposed edits make them more consistent.

Further edits on Feedback 1 template
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant