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

Redo readme #32

Merged
merged 5 commits into from
Nov 24, 2014
Merged

Redo readme #32

merged 5 commits into from
Nov 24, 2014

Conversation

jasonrhodes
Copy link
Contributor

Starting the work I mentioned in #26

@jasonrhodes
Copy link
Contributor Author

By the way you can see what this looks like on my fork: jasonrhodes/mentors

@suroorwijdan
Copy link
Contributor

@jasonrhodes Nice work. I would like to suggest here as mentoring should be more of a one-to-one discussion it will be good not to bombard the gitter channel with all the queries one may have. Though we can have general questions from new comers thrown into the channel to get help from the mentors who may be available at that point of time. Or maybe something else should be done, but will surely need some kind of guidelines around it for new people joining the program, so the process remains smooth for mentors and mentees as well.

@jasonrhodes
Copy link
Contributor Author

@suroorwijdan great point, I think this should be a responsibility of the mentors to push those discussions off of gitter and into a more 1:1 format. This is something we should definitely watch for during this trial period.

@therebelrobot
Copy link
Contributor

I thought the purpose of putting the additional info on the mentors list was so that mentees could use the listed methods to start a 1:1 conversation if they needed help? I listed my github and my twitter, both of which could be used to start a 1:1... A github issue can go unnoticed and unassigned, and the gitter is a lot more public than is appropriate for 1:1... I just don't know why more than contact info is needed, if the purpose is just to connect mentors to mentees.

In reference to #28, we could build a small front end to enable mentees to search for a mentor near them, and just list their contact info. This is the kind of thing that I would utilize if I needed it, and something I definitely could have used when I was learning.

@jasonrhodes
Copy link
Contributor Author

@therebelrobot when you say "I just don't know why more than contact info is needed", what do you mean? More than a list of mentors on the README?

The idea is to remove the burden from the person looking for help and instead let them outline what they need help with, and let mentors respond based on what they're comfortable/knowledgeable about, etc.

@therebelrobot
Copy link
Contributor

@jasonrhodes I think giving adequate tools to find experts near you removes the burden enough to make it a viable option for assistance.

Are you wanting to build a system that parses the issue and queues it to the mentor that can help best? Often mentors skills are fluid, not easily quantified enough for automatic queuing, Passive queuing is easy to ignore, and more often then not, reaching out to someone nearby to talk to face to face about your issues in your code can help break through to proper solutions.

Of course if a particular mentor is not comfortable with the issue, he can refer them to another mentor he knows has a different skillset, but the initial contact needs to happen from the mentee no matter what method we end up going with. We could either allow that initial contact to be open ended (email, twitter, git, even gitter), or we can close the process a little more (type in your issue and it hits a queue to work on), but the more the process is closed, the more it feels like (to me at least) that those we are helping are just numbers, just issues to work through, not living breathing developers that need our time and attention.

Just my two cents, but if I just have another list of issues in a queue somewhere, I'm going to find other things more pressing to work on. If someone emails or tweets me, there is a face, there is accountability, there is a sense of duty to assist.

I could be alone in that thought. If so, maybe I need to find a different org to assist with mentoring. I thought that's what this org was for though, to give mentees points of contact for assistance.

@therebelrobot
Copy link
Contributor

I just don't know how this setup is any different from stack overflow based on what you've described. In the PR, it states:

The idea is to provide more personal, specific support and hopefully develop healthy mentoring relationships rather than just a quick question/answer exchange.

A queue of issues doesn't foster healthy mentoring relationships, direct individual conversations do, otherwise stack overflow would be perfect for what mentees need.

@jasonrhodes
Copy link
Contributor Author

@therebelrobot Thanks for your feedback. The current idea is that we ask people who are volunteering to mentor to do more than just list their contact information and wait to be contacted. We're asking those volunteers to spend a few minutes a day looking through gitter and the issue queue to see if anyone has requested mentoring, and to suggest 1:1 match ups based on comfort, language, knowledge, location, etc.

This method removes the burden from the mentee. A person can just say, "I don't understand promises, can someone help?"—at which point the mentors would see this and someone comfortable explaining promises could initiate a 1:1 conversation with the person, going forward from there.

This method may not work at all, but I think it's important to get something started, even if it's minimal, and then iterate on it. That's why I suggested we time-box whatever idea we choose to start with to a few months and then evaluate how it's working, suggest changes, etc.

@nvcexploder: what are your thoughts based on the Hapi mentorship experience so far?

@mikeal @hackygolucky are you leaning a certain way on this?

@therebelrobot
Copy link
Contributor

@jasonrhodes that's fair. In that event, this org probably isn't a fit for me. I already have 3-4 different queues I sift through daily, including stack overflow, I don't see the need for another one. I'll just continue assisting from nodeschool.

I'll add my pull request to remove my name from the list today.

@jasonrhodes
Copy link
Contributor Author

@therebelrobot I don't think there's any reason to remove your name, especially as we're still trying to figure out how this works! (If I had to guess, we'll end up with something that includes both directions of initiation.) Totally up to you, but I'd love to see you stay on the list and provide feedback about the process as we go, whenever you have time.

@therebelrobot
Copy link
Contributor

@jasonrhodes Since I was so new to the group, I figured I misread the requirements somewhere. I know that if I as a mentor am going to be expected to read through issues, I'm not going to with everything that's on my plate professionally. If you're cool with having my name on there as a contact, and pick up individual conversations as they come in, that's cool, I'm happy to assist. Heck, I'll even schedule to meet in person if mentees need it. I just don't want to give the impression that I can do more than that. Adding a new queue to my workload is a huge thing, and most likely will get backburnered. No hard feelings at all, just trying to give the right info out about what I can do.

@hackygolucky
Copy link
Contributor

@therebelrobot Sorry about the confusion, as this project is in very active development/planning. It was suggested that we throw up the MVP--being the README. The momentum of that alone was quite surprising to us and caught us off guard.

As for sifting through issues, there is no intent for that to be a requirement for mentors. We intend to help encourage matching as project managers of the Mentors program. The matching mostly involves making sure the expectations of the mentors and mentees match up(time commitment, level of comfort in language, timezone located, spoken language, etc.).

Your insight is super helpful. It helps us understand what people are assuming this project does and doesn't do. Thanks for your support and encouragement, regardless of whether you continue with the project.

@therebelrobot
Copy link
Contributor

@hackygolucky No worries. I'll kill the PR for now. I just want to make sure I can commit to what you guys decide to do. I'll go lurker for the time being.


2. Ask a question on [our Gitter channel](https://gitter.im/node-forward/mentors) --a chat room that uses your GitHub login as your user account. We'll be watching that channel and responding there, hoping to pair up as we find good matches.

3. `<less public method tbd>` coming soon...
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd like to make the form 1. in this list. It does make more work, but I'd like to make sure mentees know there's no shame in private submission. It also allows us to capture the most information about how we can help.

Sent you the form draft as well!

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we just push everyone to the form and forget the issue queue? It seems confusing to offer the issue queue option if what we really want is the form submission, and then it really destigmatizes private submissions....

@jasonrhodes
Copy link
Contributor Author

OK @hackygolucky and others, I made a few changes re: what we've been talking about with pushing everyone (mentors and mentees) through the Google form. We'll just need to add the link in two places with another PR or I can add to this one, w/e.

@jasonrhodes
Copy link
Contributor Author

And here's the link to see this on my branch:

https://github.com/jasonrhodes/mentors/tree/redo-readme

@jasonrhodes
Copy link
Contributor Author

Also, see #49 for why I removed the "submit a PR" advice for now...

@jasonrhodes
Copy link
Contributor Author

OK (sorry for having a conversation with myself here) but I put the "submit a pull request to add yourself to the README) back in for now because we have #49 to discuss, so if we decide to move the list to Google Docs we can change the README then to reflect that.

Once we get the form links in there, I think this is ready to go.

@hackygolucky
Copy link
Contributor

Haven't been at my computer today but I'll try to do that this evening!

On Sat, Nov 22, 2014, 2:55 PM Jason Rhodes notifications@github.com wrote:

OK (sorry for having a conversation with myself here) but I put the
"submit a pull request to add yourself to the README) back in for now
because we have #49 #49
to discuss, so if we decide to move the list to Google Docs we can change
the README then to reflect that.

Once we get the form links in there, I think this is ready to go.


Reply to this email directly or view it on GitHub
#32 (comment).

@hackygolucky
Copy link
Contributor

@jasonrhodes I think the form is in a good place for us to drop in the url. It's at https://docs.google.com/forms/d/12OC7RgjoBvypP1HA2yBVgG31OdCSRbW4sXHMaZec0Jo/viewform?usp=send_form or I can make a new branch with your changes AND mine.

@jasonrhodes
Copy link
Contributor Author

I'll add the link to my branch in the morning and then merge it all in. thanks!

On Nov 23, 2014, at 11:32 PM, Tracy notifications@github.com wrote:

@jasonrhodes I think the form is in a good place for us to drop in the url. It's at https://docs.google.com/forms/d/12OC7RgjoBvypP1HA2yBVgG31OdCSRbW4sXHMaZec0Jo/viewform?usp=send_form or I can make a new branch with your changes AND mine.


Reply to this email directly or view it on GitHub.

@talon
Copy link

talon commented Nov 24, 2014

I noticed the timezone field is being validated as an email field and the code of conduct link isn't active. There also doesn't seem to be an explicit option to sign up as a mentor or mentee which may be intended. I like the idea of a mentor mentee scenario being a learning opportunity for both parties.

I'm excited to see this initiative progress! 😄

@hemanth
Copy link
Contributor

hemanth commented Nov 24, 2014

@hackygolucky For those looking for a mentor: fields should not be mandatory :)

@mcollina
Copy link
Contributor

Folks, how about generating a website with @jlord's sheetsee.js from the Google Spreadsheet data?

@SomeoneWeird
Copy link
Contributor

+1

@jasonrhodes
Copy link
Contributor Author

@LegitTalon and @hemanth good catches. I've made a few updates, @hackygolucky. @mcollina can you suggest that in a separate issue and reference #49 too? That way we keep things separate and focused, thanks!

I'm going to merge this request as soon as I push the form link addition.

jasonrhodes added a commit that referenced this pull request Nov 24, 2014
@jasonrhodes jasonrhodes merged commit 225b0ce into node-forward:master Nov 24, 2014
@jasonrhodes
Copy link
Contributor Author

FYI until we get that Code of Conduct up at that URL, I made that question "not required" and added "(coming soon)" to try to avoid confusion for now. We'll get those back in place as soon as the CoC is up, but for now I figure we're no worse than we were when we just accepted PRs of people's names.

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.

8 participants