website icon indicating copy to clipboard operation
website copied to clipboard

Add mentor "office hours" to project descriptions

Open sagesharp opened this issue 6 years ago • 5 comments

Many Outreachy mentors find it hard to work with applicants who are in a time-zone that is 9+ hours away. They may find it hard to balance work, life, and volunteering for Outreachy if they have to work odd hours when applicants are available. Some applicants may be able to shift their schedule if they know when mentors are available. Other applicants won't be able to, due to family or other time commitments. Allowing mentors to list their "office hours" will help applicants apply to a project that has a mentor who can be available for them.

Each Outreachy project details listing would have an "office hours" field for each mentor. Mentors can provide a short text of what hours they're available. They should make sure to include the timezone of the hours they're available (otherwise applicants will get confused). Mentors could also note vacation days or busy weeks (e.g. if they're traveling to a conference during the application period).

To keep it simple, the field would be a short (PARAGRAPH_LENGTH) CharField, we'd note in the help text that mentors should include the timezone in their office hours description.

The CharField can be added to class MentorApproval in home/models.py. You'll need to add it to the visible fields in home/views.py in the MentorApprovalAction function. You'll need to show the text on the project description page (home/templates/home/snippet/mentor_info_for_landing.html). You can add the new text from the field in the "Personal info:" section for each mentor, under the Location information.

You can follow the instructions to set up your local development environment. When you get to the instructions on setting up the current internship round, use these commands in the Django shell:

>>> from home.models import *
>>> from home.factories import *
>>> import datetime
>>> current_round = RoundPageFactory(start_from="lateprojects", days_after_today=7)
>>> current_participation = ParticipationFactory(participating_round=current_round, approval_status=ApprovalStatus.APPROVED)

That will set you up with an internship round that in the phase were mentors can submit projects, and a community that's approved to participate in this internship round. Make sure you see the new field when you submit a new project. Then make sure the new field is displayed on the project details page.

sagesharp avatar Oct 15 '19 22:10 sagesharp

Could I take this?

clussell avatar Oct 15 '19 23:10 clussell

@clussell Sure, go for it! No need to ask for permission on any issue marked "newcomers-welcome".

sagesharp avatar Oct 16 '19 00:10 sagesharp

Hi @clussell! I just wanted to check in to see if you were stuck. I know the Outreachy website code base can be confusing. I'm happy to answer questions if you comment on this PR.

sagesharp avatar Oct 23 '19 00:10 sagesharp

Note: @dimesiosfc is currently working on this issue. (Rosanne - I can't assign you to this issue, the GitHub interface is mysterious in who it allows me to assign tasks to. I suspect that once you comment on this issue, GitHub will allow me to assign it to you.)

sagesharp avatar Jul 26 '21 01:07 sagesharp

Sage,

If someone else wants to work on this you should let them. I have to squeeze this in between my regular duties and don't know when I'll have time to proceed.

FYI, I tried changing the Last Date for Project Submission, and while it changed the date in the timeline, the page still said the CFP is closed, so I'm stuck on that issue anyway.

On 2021-07-25 20:15, Sage Sharp wrote:

Note: @dimesiosfc [1] is currently working on this issue. (Rosanne - I can't assign you to this issue, the GitHub interface is mysterious in who it allows me to assign tasks to. I suspect that once you comment on this issue, GitHub will allow me to assign it to you.)

-- You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub [2], or unsubscribe [3].

Links:

[1] https://github.com/dimesiosfc [2] https://github.com/outreachy/website/issues/356#issuecomment-886301312 [3] https://github.com/notifications/unsubscribe-auth/APV4OQVTYHVSUREF32FUQX3TZSZKTANCNFSM4JBD3OTA

dimesiosfc avatar Jul 28 '21 17:07 dimesiosfc