womenwhocode / london

Women Who Code London - Mentorship

Welcome to Women Who Code London Community ✨ 💻

The Women Who Code London is a community dedicated to inspiring women to excel in their technology careers. Our events cover various topics around software engineering. If you're interested in joining the community as a member or volunteer please visit our website or join our slack.

Check out Code of Conduct

About Mentorship Programme

Mentorship is a fantastic way to get support for your personal growth and career development. Within mentorship relationships, individuals can experience mutually beneficial outcomes that extend to their personal and professional lives. Engaging in mentorship offers a chance to hone communication skills, broaden perspectives, and explore innovative approaches to various situations. Moreover, this collaborative journey allows mentors and mentees to make a significant leap in their career journey.

Please, find more information on our website.

Contributing

This website acts as a project to help introduce people to the Open Source community, and allow transition from newcomers to contributors easier.

We welcome your contributions! 💕 To contribute to this repo, follow the contributing guidelines.

About our project

How to Run Project Locally

This content is created using GitHub Pages with Jekyll.

Prerequisites

Before you can use Jekyll to test a site, you must:

1. Install Jekyll. Create a Jekyll site. For more information, see "Creating a GitHub Pages site with Jekyll." We recommend using Bundler to install and run Jekyll. Bundler manages Ruby gem dependencies, reduces Jekyll build errors, and prevents environment-related bugs. To install Bundler:

2. Install Ruby. For more information, see Installing Ruby.

3. Install Bundler. For more information, see Bundler

Build and run

• Run on terminal bundle install

• Run on terminal bundle exec jekyll serve

• Access the page on browser: http://127.0.0.1:4000

External Links about GitHub Pages

• GitHub Pages Doc
• About GitHub Pages and Jekyll
• Test locally with Jekyll

How to Troubleshoot Building Project Locally

The project requires to use ruby>=3.1.*. Make sure that your system looks at the correct version of ruby.

Possible errors

after bundle install command.

Setup ruby with rbenv

• First, check which path of ruby you have. If it's incorrect or missing, set it.

env | grep PATH

export PATH="$HOME/.rbenv/bin:$PATH"
eval "$(rbenv init -)"

To install the correct ruby version, use the following command:

rbenv install 3.1.2

• Set the 3.1.* version of ruby as the default one globally or only for your working directory.

rbenv global 3.1.2  # set the default Ruby version for this machine
# or:
rbenv local 3.1.2   # set the Ruby version for this directory

• Get back to the Build and run section.

Remove Gemfile.lock

As an alternative way, remove Gemfile.lock if setting Ruby version didn't help.

How to Run End-To-End Testing Locally

1. Open your Terminal in the e2e-tests folder, e.g. cd ~/workspace/london/e2e-tests
2. npm install cypress --save-dev - This will install Cypress locally as a dev dependency for your project.
3. Run npx cypress open from your project root
4. Select E2E testing

5. Select E2E testing option.

6. Choose your browser and click Start E2E testing in....

Now you can run any tests from Specs.

For more details, please refer to the official Cypress Documentation.

london's Issues

bug: JS error in console related to navbar

Bug Report

Describe the bug

There is an issue on JS related to menu trying to add class into undefined object.

To Reproduce

Steps to reproduce the behavior:

1. Go to the website
2. open inspect the code
3. check console log
4. See error navbar.js:23 Uncaught TypeError: Cannot read properties of undefined (reading 'addClass')

Expected behavior

No exception should be trigger on console while navigating into our website

Screenshots

Reproducibility

• The bug is reproducible consistently.

Impact

• It is blocking test automation

feat: Improve search on mentor page

As of now, the search's UX is not great. We should implement the following changes to improve it

1. Add a search button
2. Keyword search should take place on keypress
3. Should show the count of search result
4. Add loader while search is going on
5. Mentor images should be mapped by the Index https://wwcodelondon.slack.com/archives/C046TG3MHJR/p1688843216863139

feat: Add unit test cases

Is your feature request related to a problem? Please describe.

To have good-quality of code we should have test cases

Describe the solution you'd like

I would like to have test cases (unit, E2E) for our code-base

Describe alternatives you've considered

NA

Additional context

NA

feat: Add explanation for ad-hoc in main page

In order to bring more visibility to ad-hoc sessions, we should add a new session on the home page to explain it is an ad-hoc session.

fix: Mentor's search by text is not working

When searching by mentor name and any other text on the mentor's page it is not filtering correctly.

QA Automation: Study group page UI

Describe the solution you'd like

Open Study group page and verify all UI elements, no functional scenarios, just to make sure that all elements exist and visible, verify the values for all links located on the page.

Additional context

Create folders and structures based on the example with Home page (locators, pages, steps files)

QA Automation: Team page UI

Describe the solution you'd like

Open Team page and verify all UI elements, no functional scenarios, just to make sure that all elements exist and visible, verify the values for all links located on the page.

Additional context

Create folders and structures based on the example with Home page (locators, pages, steps files)

fix: replace contact email in code of conduct with the new one

Improvement Report

Describe the improvement

Replace [email protected] email address with the new email - [email protected]

Link to the Code of Conduct: https://womenwhocode.github.io/london/code-of-conduct#

feat: Create automation test suite

Create setup to run end-to-end testing and create documentation.

Add search in FAQ page

Would be nice to have a search page in the FAQ page to be easier to find topics.

Can be very simple by text for example. An example could be the mentor's page search but only the keywords attribute.

feat: Improve SEO tags

SEO tags makes easier to search engine tools to find our page and improve the ranking in the list.
We need to improve the used keywords and maybe have different tags by related page.

fix: Limit mentors area to the same size

In order to make the mentor's page with the same space between mentors, it is necessary to implement the following:

• limit the mentor's bio area to a specific size (css width)
• add a button to "read more" which will show the complete bio information.
• and the Show less button to hide the information
• only shows the buttons to hide and show the details of the bio text that has more than a limited characters number for example. But any other logic can be applied.

Replace multiple <h1> headers to a single one on the Events page

It is considered a bad practise to use multiple <h1> headers on the page: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements.

It is better to use multiple h2 tags instead and use 1 h1 tag (it can be hidden for usual users and seen by readers, see visually hidden pattern)

QA Automation: Navigation between the rest website pages

Is your feature request related to a problem? Please describe.

A functional test representing the use case of navigation between website pages (All scenarios that are not covered in #181 and #180). Create one BDD test with multiple scenarios, if it’s too big, split it but not 1 scenario = 1 test.

feat: Show Mentors hours per month

Include in the mentors card the total of hours available per month for mentoring.

• In the Mentor data has already hours per month
• In case the hour is zero, it should not show the availability.

feat: display number of sessions on the mentor profile

Is your feature request related to a problem? Please describe.

It would be beneficial for the programme to display number of the sessions happened on the mentor profile

Describe the solution you'd like

Create additional element on the mentor profile to display the number of session mentor conducted with mentees

Describe alternatives you've considered

N/A

Additional context

N/A

feat: Re-organize Menu and Sub-menu

1. HOME
2. MENTORS
3. RESOURCES
4. HOW IT WORKS (no page, it is just to group the links)
   4.1 LONG-TERM RELATIONSHIPS TIMELINE
   4.2 AD-HOC MENTORSHIP TIMELINE
   4.3. CODE OF CONDUCT
   4.4. FAQ
5. TEAM

feat: Mentors number of sessions

To bring visibility for more active mentors we will expose whenever possible to total number of sessions this mentor has done on this year.

This information could be included on his profile, but should not be mandatory. In case the mentor does not have this information, it should not show the info.

feat: create new tab on mentor's profile - reviews

Is your feature request related to a problem? Please describe.

It would be a good additional feature to have reviews for each mentor from mentees and book recommendations from each mentor

Describe the solution you'd like

Add two new tabs: Reviews (number of reviews available) and Book Recommendations

Additional context

Template for Reviews (content for the tab)

Template for Book Recommendations (content)

QA Automation: Navigation from Home to Long-term timeline

Is your feature request related to a problem? Please describe.

A functional test representing the use case of navigation from Home to Long-term timeline page: 1. Via header, 2. Via 'Check more details’ button. Create one BDD test with 2 scenarios

doc: Improve pull request template

In order to make clear the steps to open a pull request and the important of run locally and add screenshots we should improve the template as check and make sure all contributors are aware of that.

feat: Add "Applaud her" section or page

Is your feature request related to a problem? Please describe.

1. Add a page, or a section on homepage for "applaud her"
2. This would have a profile image, text, and social media links to applaud the mentor, mentee, or volunteers

Describe the solution you'd like

A dedicated page, or section which can have monthly, or weekly feature of mentor, mentee, and volunteer

Describe alternatives you've considered

NA

Additional context

NA

QA Automation: Navigation from Home to Mentors

Is your feature request related to a problem? Please describe.

A functional test representing the use case of navigation from Home to Mentors page: 1. Via header, 2. Via 'Check our Mentors' button. Create one BDD test with 2 scenarios

QA Automation: Mentors page UI test

Describe the solution you'd like

Open Mentors page and verify all UI elements, no functional scenarios, just to make sure that all elements exist and visible, verify the values for all links located on the page.

Additional context

Create folders and structures based on the example with Home page (locators, pages, steps files)

feat: Enable registration based on mentors availability

Currently, we initiate mentee registration for ad-hoc sessions on a monthly basis, enabling them to apply for mentors. Given that mentors may have availability in specific months, it would be more flexible to establish a structured timetable. This would involve reaching out to mentors beforehand to ascertain their upcoming availability.

Technical details:
Additional fields in yml should look like (we can put only two months for now and later extend):

availability: [5, 6, 7, 8] 

Logic is following:
Button should be enabled the first 7 days of the month and disabled after that.

QA Automation: Mentors search + filters

Is your feature request related to a problem? Please describe.


Combine mentors with different filters. Create multiple scenarios in 1 BDD test. If it’s too big, split to 2 or 3 tests.

QA Automation: Code of Conduct page UI

Describe the solution you'd like

Open Code of Conduct page and verify all UI elements, no functional scenarios, just to make sure that all elements exist and visible, verify the values for all links located on the page.

Additional context

Create folders and structures based on the example with Home page (locators, pages, steps files)

feat: Add Events Section on Resources Page

Add one more section on Resource Page to store our upcoming event like Panel Discussion, Kick-off Meeting, Catch-Up, some other events.

You can find a prototype below:

feat: Create new property "disabled" in mentors.yml

In case mentor requested to be disabled on the website for some time (for several weeks or months), it would be helpful to have a logic which allows to change only one property in mentors.yml, like:
disabled: true/false

fix: Home page for mobile devices

Fix the home page on mobile devices:

• Adjust buttons font-size for example
• double check all pages if anything is broken

Create a timeline for ad-hoc format

1. Create a new tab in HOW IT WORKS -> AD-HOC FORMAT TIMELINE
2. Rename tab from TIMELINE to LONG-TERM FORMAT TIMELINE
3. Implement ad-hoc timeline the same as for long-term format using the following text:

Application period: Every month, interested mentees will have the opportunity to apply to the one-time mentorship session program. The application process will be open for a specific period of time (a few weeks), and the applicants will need to provide information about their background, interests, and goals for the mentorship.
Mentee selection: Once the application period has ended, the Mentorship Programme Team will review the applications and select the mentees who will participate in the program for the next month.
Mentor notification: The Mentorship Programme Team will send a list of selected mentees to the mentors, along with their profiles and information about their goals and expectations for the mentorship.
Scheduling sessions: Mentors will send a Calendly link and list of mentees to the Mentorship Programme Team, allowing these mentees to schedule sessions with the mentor directly.
Session preparation: Before each session, mentors and mentees should prepare and plan for the meeting, setting clear goals and objectives for the session.
Session: During the session, mentor and mentee should engage in meaningful and productive discussions, working towards the goals and objectives. Mentor should provide guidance, advice, and support to mentee, helping him/her to grow and develop his/her skills and knowledge.
Feedback: After one-time session mentors will ask mentee to provide his/her feedback on the session and the program itself.
Program evaluation: At the end of each month, the Mentorship Programme Team will collect feedback from mentors and evaluate feedback from mentees to identify areas for improvement and make any necessary adjustments.

feat: Add link to the Instagram in social media graphics

QA Automation: Long-term timeline page UI

Describe the solution you'd like

Open Long-term timeline page and verify all UI elements, no functional scenarios, just to make sure that all elements exist and visible, verify the values for all links located on the page.

Additional context

Create folders and structures based on the example with Home page (locators, pages, steps files)

bug: Link to the video for the two first events redirects to the same video link

Bug Report

Describe the bug

Link to the video for the two first events redirects to the same video link.

To Reproduce

Steps to reproduce the behavior:

1. Open the link: https://womenwhocode.github.io/london/resources
2. Navigate to the Events Section
3. Click on the youtube icon for the two first events
   

Actual behavior

Two links redirect to the same video: https://www.youtube.com/watch?v=AuDyfjDr9rA

Expected behavior

What makes a good mentor? Panel Discussion - https://www.youtube.com/watch?v=AuDyfjDr9rA
How to get the most out of Mentorship Programme? Panel Discussion - https://www.youtube.com/watch?v=mznVrMbcFxk

Desktop (please complete the following information):

• Browser Chrome

Reproducibility

• The bug is reproducible consistently.
• The bug is sporadic or occurs randomly.

Impact

• The bug affects critical functionality.
• The bug affects minor functionality.
• The bug is a cosmetic issue.

feat: Update Website Banner

The website will be used not only for mentorship programs but for all programs in wwc London.

This will be the first step to do it.

feat: Add "Join our slack community"

Include this link for our slack group in the footer as part of our social medidas.

QA Automation: Ad-hoc timeline page UI

Describe the solution you'd like

Open Ad—hoc timeline page and verify all UI elements, no functional scenarios, just to make sure that all elements exist and visible, verify the values for all links located on the page.

Additional context

Create folders and structures based on the example with Home page (locators, pages, steps files)

Add default profile image for mentor when failed to load their own image

Currently, mentors' image is loaded by their own Linkedin or Slack, but in case they change their profile the image link we have on the page will not be loaded. For such cases, it is better to show a default image.

Current error:

Expected:

The idea is to solve with JS or Jquery

feat: Upgrade google analytics version

Upgrade google analytics library and account to use the mentorship email account.

feat: create mentors search

I would like to filter the mentors list by:

• Type of mentoring: ad-hoc or long-term relationship

• Tech Experience:

  • 0-2 years
  • 3-4 years
  • 5-7 years
  • 7-10 years
  • 10-15 years
  • +16 years

• Areas:

  • Backend Developer
  • Distributed Systems
  • Data Engineering
  • Machine Learning
  • Data Engineering
  • Business Analysis
  • Product Management

feat: Create Pagination in mentor's page

Add a pagination plugin or feature in the mentor's pagination.

Suggestion: https://jekyllrb.com/docs/pagination/

QA Automation: FAQ page UI

Describe the solution you'd like

Open FAQ page and verify all UI elements, no functional scenarios, just to make sure that all elements exist and visible, verify the values for all links located on the page.

Additional context

Create folders and structures based on the example with Home page (locators, pages, steps files)

feat: create a button on the website to submit technical issue

Create a button on the HOME page to submit technical issue with github issue creation.

QA Automation: Resources page UI test

Describe the solution you'd like

Open Resources page and verify all UI elements, no functional scenarios, just to make sure that all elements exist and visible, verify the values for all links located on the page.

Additional context

Create folders and structures based on the example with Home page (locators, pages, steps files)

bug: On Mentor's bio buttons Show less, Show more displayed even if there is no text to hide

Steps to reproduce:

1. Open https://womenwhocode.github.io/london/
2. Navigate to Mentors Page
3. Find mentor's bio where there is no need to show more text
   Expected result: there should not be a button "Show less" displayed
   Actual result:

Screen.Recording.2023-07-25.at.09.35.37.mov

QA Automation: Support local runs

          I think version 1 would be completely fine to access `prod` env. But would be nice to have the chance to run locally from the local environment. Which this path would not work. But not a blocker, but we can create an issue to be taken care of during our study group, what do you think?

Originally posted by @dricazenck in #164 (comment)

bug: No "Bio" truncation in some mentors' profiles but the "Show more/less" button is still visible

Bug Report

Describe the bug

For each mentor's card, the "Bio" section under the "Presentation" tab is expected to not show the "Show More/Show Less" button if the mentor's bio is not long enough for truncation. This works for some profiles but not for the one shown in Screenshots (and possibly others):

To Reproduce

Steps to reproduce the behavior:

1. Go to Mentors section
2. Search for mentor with Claudia
3. See error

Expected behavior

The "Show More/Show Less" button should not be visible for this mentor since their Bio is not truncated.

Screenshots

Reproducibility

• The bug is reproducible consistently.
• The bug is sporadic or occurs randomly.

Impact

• The bug affects critical functionality.
• The bug affects minor functionality.
• The bug is a cosmetic issue.

Proposed Solution (optional)

If you have any ideas on how to fix the bug or potential areas to investigate, suggest them here.

Your Contribution (optional)

If you're able and willing to contribute a fix, mention it here.

feat: Use new default image for mentors profile

In case the mentors does not provide his profile picture or it is the default one from his social media, it should be replaced by Women Who Code default profile image. (To be provided by our team soon)

bug: Contribution guidelines, open an issue link to be updated

Bug Report

Describe the bug

1. As of now, in the contribution guideline "open an issue" link is redirecting to the issues page

To Reproduce

Steps to reproduce the behavior:

1. Go to '...'
2. Click on "open an issue"
3. It will take you to the issues page

Expected behavior

We should update the link so that it will go to: https://github.com/WomenWhoCode/london/issues/new/choose

Screenshots

NA

Desktop (please complete the following information):

• OS: [e.g. iOS]
• Browser [e.g. chrome, safari]
• Version [e.g. 22]

Smartphone (please complete the following information):

• Device: [e.g. iPhone6]
• OS: [e.g. iOS8.1]
• Browser [e.g. stock browser, safari]
• Version [e.g. 22]

Reproducibility

• The bug is reproducible consistently.
• The bug is sporadic or occurs randomly.

Impact

• The bug affects critical functionality.
• The bug affects minor functionality.
• The bug is a cosmetic issue.

Additional context

Add any other context about the problem here.

Related Issues/PRs

If you know of any related issues or pull requests, link them here.

Proposed Solution (optional)

If you have any ideas on how to fix the bug or potential areas to investigate, suggest them here.

Your Contribution (optional)

If you're able and willing to contribute a fix, mention it here.

feat: Sort Mentor's page

Sort Mentor's page by mentorship type (ad-hoc, long term relationship or both)