Web: design - /mentors page

Created on 8 Mar 2018  路  59Comments  路  Source: gitcoinco/web

Why

Mentorship is a proven model for growing developers skills, careers, and networks

What

Data Object

Mentor

See this spreadsheet for example

  • Github handle
  • Name (optional)
  • email
  • Yrs programming experience
  • Wants membership in (list of varchar)
  • offering membership in (list of varchar)
  • Available for new mentees? (y/n)
  • Time Commitment
  • Comments

Pages

First page - index page

A page that lives at /mentors. Page is a list view of mentors that are available to mentor developers. - Only lists mentors if Available for new mentees is y

This page can be accessed from /tools and from the footer.

Second page - detail page

The detail page for each individual mentor object. Only displays if Available for new mentees is y

Second page alt -- edit detail page

This page can be accessed from the menu in the top right of Gitcoin.

It allows editing of the Mentor object associated with my Gitcoin/Github Handle.. I can edit any of the fields in the data object from it.

Third page -- Email -- Mentor Match

Based upon the design of https://github.com/gitcoinco/web/issues/563, this page will be an email notifying a user that there is a potential mentor match available.

Bounty

Please post a mockup of each of these pages. I expect that the core team will want to do two revisions on each page before they are finalized.

You are encouraged to leverage assets from https://github.com/gitcoinco/creative (especially the brand guide)

community member

Most helpful comment

gitcoin_mentors_index
Latest rendition with some of the requested changes and some new formatting to handle real estate. Gold skills are non-development skills.

All 59 comments

MFW you posted this

giphy

Super looking forward to these designs! 馃憤

@mkosowsk your gif game => 馃

Thanks! I've been memeing since Internet 1.0. If you check out the YTMND power users you may see someone with a curious name that may or may not be me 馃槀

What exactly does the deliverable for this look like? HTML files?

@owocki Is Gitcoin Bot on vacation or did @mkosowsk scare it/her/him away? 馃檮

馃檪

What exactly does the deliverable for this look like? HTML files?

just the designs.. in the past we've seen Sketch files or PSDs..

@owocki Is Gitcoin Bot on vacation or did @mkosowsk scare it/her/him away? 馃檮

not sure; looking into it. meantime, heres the gitcoin link for this => https://gitcoin.co/issue/gitcoinco/web/565

@vs77bb I'm surprised you'd say something like that, as you know I have a great relationship with the robot community 馃檮As a matter of fact, just ordered a Roomba 980, can't wait to give her a test run 馃憤馃徎

@owocki I'm not familiar with the nuts and bolts of Gitcoin Bot, but here are some actions I took on this ticket that may have tripped the poor robot up

  1. Posted an inline gif, Gitcoin Bot might not like this?

  2. Posted _very_ clickly after your initial post, think <1 minute... sorry but mentorship has a special place in my heart!

  3. Also edited my post shortly after I posted it, looking for the most choice 馃憣馃徎meme

__Work has been started on the 0.25 ETH (178.02 USD @ $712.09/ETH) funding by__:

  1. @cmac2454

__Please work together__ and coordinate delivery of the issue scope. Gitcoin doesn't know enough about everyones skillsets / free time to say who should work on what, but we trust that the community is smart and well-intentioned enough to work together. As a general rule; if you start work first, youll be at the top of the above list ^^, and should have 'dibs' as long as you follow through.

On the above list? Please leave a comment to let the funder (@owocki) and the other parties involved what you're working, with respect to this issue and your plans to resolve it. If you don't leave a comment, the funder may expire your submission at their discretion.

gitcoin_mentors_1

Here's what the page is looking like so far. I'm mimicking the Issue Explorer list design for consistency but I'm open to other ideas. I've also added some filters to the side similar to an online store so that you can filter mentors for something you're specifically looking for.

Looks awesome! 馃憤

Some thoughts:

  1. Probably worth it to put some thought into Email Address Obfuscation to trip up spambots. I've seen things like "Click here" for email address that obscures the email and when clicked shows the email address, would this work for our purposes?

  2. I think it's probably worth it to have Experience (Years) in the Mentors table... open to discussion on this tho 馃

  3. There was a Google Sheet floating around that was perhaps a precursor to this issue called "Mentorship Interest Matching DB". This had two columns that I think would of interest here:

A. Available for new mentees? (Boolean)
B. Time Commitment (Hrs/week)

Very happy to see this one coming along! And because Mentorship has such a near and dear place into my heart, I would like to pre-emptively call dibs on working on bringing these designs to life through Code (assuming I get #506 into a ready state by then!)

Probably worth it to put some thought into Email Address Obfuscation to trip up spambots. I've seen things like "Click here" for email address that obscures the email and when clicked shows the email address, would this work for our purposes?

Would it be better if we only showed the email in the details page through the obfuscation? I could use that real estate for some of the other parts you mentioned then.

Would it be better if we only showed the email in the details page through the obfuscation? I could use that real estate for some of the other parts you mentioned then.

That makes sense to me! But I would defer to @PixelantDesign 馃憤

great start! excited for this :)

Would it be better if we only showed the email in the details page through the obfuscation?

i agree.

But I would defer to @PixelantDesign 馃憤

agree here too :)

A. Available for new mentees? (Boolean)

Is this part necessary? The original design statement said this:

Only lists mentors if Available for new mentees is y

So we shouldn't have to display it because that should be assumed. Am I getting that right?

So we shouldn't have to display it because that should be assumed. Am I getting that right?

yes

gitcoin_mentors_index
Latest rendition with some of the requested changes and some new formatting to handle real estate. Gold skills are non-development skills.

some thoughts:

  1. can we add the user's github avatars on the left hand size to humaize this list a little bit?
  2. i advocate for alternating each row's background-color a little bit so it's easier to follow the data left <> right across the screen

@owocki I'm glad you mentioned those because those were my next ideas for the design!

screen shot 2018-03-09 at 11 54 20 am
Avatars added, row background colors alternated for easier readability

Looking good @cmac2454!
Have you considered putting skills at the top of the left column? When thinking about finding a mentor, a user is likely to be interested in what they're trying to learn vs. where their teacher works.

Would love to see what onboarding into this looks like!

Have you considered putting skills at the top of the left column?

@PixelantDesign I was thinking about that. Maybe skills first, experience second, org third?

Would love to see what onboarding into this looks like!

Are you referring to the application/creation process from the perspective of a Mentor?

@PixelantDesign I was thinking about that. Maybe skills first, experience second, org third?

makes sense to me

Would love to see what onboarding into this looks like!

this is the page i intended Second page alt -- edit detail page from the spec to be.. i can't speak for @PixelantDesign , but i too am excited to see what this looks like!

Questions about the flow of becoming a mentor:

Will it be available under the drop menu next to the username in the top right? (e.g. "Mentoring settings" options)

Would we like the mentoring onboarding/details to be treated more like a personal settings page (e.g. "turn on" mentoring and alter settings) or like a Tools page?

On a different note, I can't upload screenshots to this comment thread for some reason, but I can upload a screenshot of the email template to imgur if you're interested.

@cmac2454

@PixelantDesign I was thinking about that. Maybe skills first, experience second, org third?

I think that works.

Are you referring to the application/creation process from the perspective of a Mentor?

I was initially thinking for a user looking for mentor. I do think an ftux for the mentor is important as well but probably out of scope for this ticket.

One question I had was the time commitment column, is that instructor's committment or my time commitment as someone seeking a mentor?

Thinking about commitment and time, a statement is a good way to get users committed and follow through on their goal. This could be generated from an ftux that captures this information. Another commitment device that has been shown to work is simply sharing that statement either via email or a tweet (obviously out of scope for this but just some ideas there). Here is an example, please don't feel like you have to use this, just ideas to help spark thinking around this.

screen shot 2018-03-12 at 11 18 57 am

I wanted to also mention that we have a UI Kit which I'm not sure if you've seen or not, but might be helpful as you are designing the screens. I'm in the process of introducing Muli into our font family so you'll start seeing this throughout the app.

Last question - what is the thinking behind blue vs. green tags?

Looking good!

@PixelantDesign Thanks for the feedback! I'm definitely utilizing the UI Kit as I design this and I went and got the Muli font so I'll keep an eye out for it on the site and work on integrating it into designs.

One question I had was the time commitment column, is that instructor's committment or my time commitment as someone seeking a mentor?

That number comes from the number of hours that that individual is willing to commit to being a mentor per week. I do like the idea you put in the header as well, with a sort of statement for what they want to learn, a possible deadline and the amount of time they can commit. I think that'll also help if they have a smaller commitment than a mentor would find feasible for their task. I can look at incorporating something of that nature into the design.

Last question - what is the thinking behind blue vs. green tags?

I realized that some individuals had asked for and provided some non-development skills (e.g. business-oriented) so I wanted to denote those with a different color for browsing readability. That way if a user is looking for someone who has business skills but they are unsure of what they are looking for, they can just keep an eye out for the appropriately colored tags. I think it also helps discern which mentors are more development-oriented vs other categories. We could add more colors to the palette for more categories if we were interested (e.g. Regulus Red for Design, etc.)

@owocki @PixelantDesign Do we want the Mentor Details page to live on its own or do we want those details to live on the Profile page and be edited and displayed there?

i was thinking it'd be it's own page that would link off to the profile detail page.. cc @PixelantDesign

Thanks for the clarification @cmac2454
I think the blue and green works for the tags...btw are those tags clickable? If not, I'd suggest looking at the ETH/USD tags i've defined in the UI Kit and define newer informational tags in a similar style.

I also think mentor details should be it's own page.

Thank you!

@PixelantDesign Those tags are meant to be clickable, yes. I was thinking they could serve as an alternate way to add skill filters (by clicking on the skills you were interested in on a profile). I can still redesign them if you want them to be a little more on-brand.

I'll make a separate page for the mentor details!

Here's a link to view the email template as it is so far.

@cmac2454 Looks slick!!!

@mkosowsk Thanks! Any feedback/features you think I should have?

May be overloaded but think it might be good to include their Slack name if they are active on the Gitcoin Slack? Slack is nice for communication and if they are active on Gitcoin Slack this might kill two birds with one stone

I defer to @PixelantDesign tho, my designs tend to get super overloaded with crap 馃槀

May be overloaded but think it might be good to include their Slack name if they are active on the Gitcoin Slack?

This makes sense to me

those both look pretty good to me!

Becoming a Mentor

we may have to adjust to use our form-styles a little more consistently and maybe add an image / title / subtitle up top, but otherwise looks good.

New Mentor Match Email

It might be neat to surface which skills you and the match have in common.. but otherwise this looks good.

Skills surfaced on email

Working on fixing mentor page to be consistent with form-styles

Looking good @cmac2454!

Have you considered using a drop down for years of experience and hours a week to commit to mentoring? That way user have a number or ranges to work with, it'll be easier to complete and we won't get wildly different answers for the numbers.

I might move the last question to it's own line "Are you available to mentor now?"

My only other comment would be to double check header, font, and default button styles defined in the ui toolkit.

@PixelantDesign

Have you considered using a drop down for years of experience and hours a week to commit to mentoring?

I did! I wasn't sure how granular or general we wanted to be, so I'll spin up a version with drop downs.

I might move the last question to it's own line "Are you available to mentor now?" My only other comment would be to double check header, font, and default button styles defined in the ui toolkit.

Will do and will do.

Updated designs

Dropdown example

@owocki @PixelantDesign Any thoughts, questions, concerns?

__Work has been started on the 0.25 ETH (105.58 USD @ $422.33/ETH) funding by__:

  1. @cmac2454

__Please work together__ and coordinate delivery of the issue scope. Gitcoin doesn't know enough about everyones skillsets / free time to say who should work on what, but we trust that the community is smart and well-intentioned enough to work together. As a general rule; if you start work first, youll be at the top of the above list ^^, and should have 'dibs' as long as you follow through.

On the above list? Please leave a comment to let the funder (@owocki) and the other parties involved what you're working, with respect to this issue and your plans to resolve it. If you don't leave a comment, the funder may expire your submission at their discretion.

Hi @cmac2454 thanks for sharing the updates!

I think it might make sense to align the mentor form page with what @KennethAshley is doing with the grants form. You'll be able to leverage the structure, grid, type sizing, etc. Take a look here. Image wise you could use what Kenneth is using or create a new graphic more specific to mentoring in general.

@KennethAshley could you share your sketch file with @cmac2454 once you've nailed down the changes to the grants form?

@owocki this might help speed up development a bit too if we can reuse templates.

@PixelantDesign I took a look at @KennethAshley designs and I'll be looking at updating mine to be closer to his style. I may also create a new graphic like you suggested. I'll be interested in seeing the Sketch file and happy to help with the development of templates if needed.

Updated the mentoring onboarding with the format from previous designs from KennethAshley.

Design A

Design B

Design C

@owocki @PixelantDesign @KennethAshley Any feedback and/or pointers are welcome!

i like the cap. nice touch.

@cmac2454 can you post the Sketch files for this? I am going to open up a frontend coding ticket for this today.

@owocki They're Illustrator files, I hope that's okay.

Email Template

Onboarding

Mentor Browser

I think version B works @cmac2454

@owocki for the build ticket, I recommend we leverage the form that @KennethAshley is building on #380

@owocki @PixelantDesign Any other design changes or desires?

Commenting to prevent gitcoinbot from removing me.

@owocki Can I submit work for this or do you need anything else?

looks okay to me. cc @PixelantDesign in case she has any feedback. go ahead and submit

@PixelantDesign Submitting work for this issue, please let me know if you have any further feedback.

__Work for 0.25 ETH (95.85 USD @ $383.4/ETH) has been submitted by__:

  1. @cmac2454

Submitters, please leave a comment to let the funder (@owocki) (and the other parties involved) that you've submitted you work. If you don't leave a comment, the funder may expire your submission at their discretion.

Looks good. Thank you @cmac2454!

__The funding of 0.25 ETH (93.58 USD @ $374.31/ETH) attached to this issue has been approved & issued to @cmac2454.__

Was this page helpful?
0 / 5 - 0 ratings