At the moment, we only have content on how to figure out what goals to set. However, where people often get stuck is with the actual setting of their goals (making them realistic, measurable, etc).

In places there are callouts using syntax that doesn't render

{% hint style="info" %} 💡Pro tip: [Here](https://www.youtube.com/watch?v=K3iJwoydBbg) is a video that explains the GROW model, which is a model that helps us uncover what you need guidance on. The video explains it from a coach’s point of view. Pay attention to the definitions of each part of GROW. {% endhint %}

Often mentees are unsure as to how to make sure that their mentoring relationship with their mentor is mutually beneficial. Some pro-tips on this topic may be useful.

Description

The code in the repository is copied across from another repo and superfluous code needs to be removed.

Include GitHub profile images of contributors to each section at the bottom of the homepage

We have a messy scrolling issue (see video); we'd really like the squishy "Developer Mentoring Guide" that appears when the navbar disappears to be removed 🙏 Eternal gratitude awaits anyone who can give this a fix!

It would be great if visitors could leave comments at the end of an article/document!

Kind of like this below (see link here).

Also, is it possible to like the comments and sort them according to the number of likes and the latest comments?
And, if possible, automatically replace the entry with the comment with the most likes?

Add content on:

• Your first meeting
• Mentoring session template
• Guidelines for meetings

Looking for recommended books for devs!.

Titles should be accompanied by an image of the book cover and ideally follow the same formatting at this recommendation (but feel free to clean up if you think we could improve).

Mentoring and coaching are quite different and people often get confused between the 2. It would be useful to add a paragraph or 2 on the difference between mentoring and coaching so that it's clear.

Replace the link-out with a GitHub logo next to the word "GitHub" on the right-hand side of the navigation bar.

Consider adding a license for the text materials.

The text in markdown files should not be considered code. Thus it should not fall under the MIT license clause.
Usually, content falls under knowledge-sharing, research, or literal creative works. The CC license should be a good choice.

Need to add this Docusaurus Plugin ➡️ plugin-ideal-image

Users should be able to download a copy of the mentoring agreement from this section (e.g., link or attachment)

The current favicon is black/dark grey which disappears when the browser is in dark mode.

• We'd like to replace it with the white favicon when in dark mode

Heyo! We're interested in this plugin which would allow for zoom in/out on images in your documentation. If anyone could get this going that would be muchos appreciados (bad Spanish?) 🧐

The OfferZen logo in dark mode is black at the moment, we'd like to change it to white.

The official OfferZen font is Promixa Nova (is it possible to change it across the site?)

We need to add a section explaining what mentoring is.

Can we add prettier.rc file to the project to enable a consistent code formatting for everyone developing?

Read more at: https://prettier.io/

The search functionality is basic and could do with implementation of full search features. At the very least the hacky CSS in #11 should be done better and the box could be prettier.

We want to add our site to the docusaurus showcase 😁

Just post a comment in GitHub discussion with some basic information:

Site URL: live production deployment URL of your site
Site source code URL: only for open-source sites
Site title
Site description: ≤120 characters
Tags: see below the list of available tags

Need to add this Docusaurus plugin 🛠

We want to know what we could be doing to better optimise our images for SEO (e.g., image size/compressing images, image alt tags, etc.). Any help or advice with these would be super appreciated 🚀🚀🚀

See example:

Heyo! 🚀 We want our sidebar to have "new" next to the titles of some of our recently uploaded articles/pages — can anyone help with this

Heyo! 🚀 We're hoping to add a Google forms feedback component to some of the pages in our guide! If anyone could help with this we'd super appreciate it! 🙏

Kind of like the image below (see repo [here])(https://github.com/CodeYourFuture/syllabus/blob/master/src/theme/Feedback.js)

Description

The image and file paths in the repo are relative and confusing. Find a simple way to make the paths easier to use.

Heyo! We're interested in adding a PDF generation feature (there's this here but if anyone has any better ideas we'd be super open to hearing them 👂)

Heyo! 🚀 We've spotted one or two punctuation errors on this page of the guide—if someone could go into the markdown file and double-check that would be great! 🙏

The current layout of the welcome/about/introduction section is messy. I think it should be changed to:

Introduction

• Welcome to the Developer Mentoring Guide (explanation of the guide & how to use it)
• About OfferZen (with link to platform)
• About Thrive (with link to Thrive landing page/applications)

It seems the icons of the contributors located at the bottom of the readme are not updating as new people contribute.

• We want the readme to show the icon of new contributors automatically as they contribute.

Need to add this URL to each mention of 'Project Thrive'

These last two mentor types (the Sponsor and the Affirmer) seem very similar to the Connector and the Coach respectively--consider combining or removing them?

Need to add this Docusaurus Plugin ➡️

Currently not compatible with the docusaurus set up 🦖. Needs to be rebuilt.

Include "Last modified" at the end of each page(dd-mm-yyyy)

An idea of a living "document", open and available to all mentoring pairs. To act as both a guide and historic record of the relationship(s). A means to provide the necessary resources and template for the journey, as well as to allow the "document" to grow over time with each mentoring pair. While being available to all mentoring pairs to provide further guidance and a means to track and hold each other accountable through each progressive journey.

Create a fork of the repo once grounded as a base, then each mentoring pair creates a branch to work off and "complete" through their unique experiences and resources gathered and shared.
@OfferZenThrive

For the section titles (chapters?), it's not immediately clear what each section is about. We need to edit these to make it easier for people to find what they need.

The dark mode colour being used should be: #2F96F4

Section to be renamed something like "What is mentoring?'

Proposed outline:

Mentors

• What is a mentor?
• Benefits for a mentor
• Types of mentors
• Qualities of a good mentor

Mentees

• What is a mentee?
• Benefits for a mentee
• Qualities of a good mentee

The mentoring relationship

• What mentoring is and isn’t
• The difference between a mentor and a coach

Heyo! 🐱 Anyone know how to embed videos in docusaurus/markdown files? (see example below)

The journey broken down into steps/milestones with resources relating to each phase of the journey.
A comprehensive living document growing with the relationship, stimulating growth in the relationship and acting as a guide for future relationships.
@OfferZenThrive

Add content on how to set expectations for the mentoring relationship as well as a templated mentoring agreement example.

Aim: Help mentors identify which one of several mentor types to help them get more out of their mentoring experiences.

Need help with building out/integrating this quiz

Link to Types of Mentors page

Quiz Structure:

You are an advisor if you answer ‘yes’ to these questions:

• Do you feel that your experience entitles you to indicate how problems need to be solved?
• Do you believe that reasonable solutions can be difficult to find, so you insist mentees follow your advice?
• Do you define mentoring as offering solutions to problems?

You are a protector if you answer ‘yes’ to these questions:

• Do you feel that your mentee needs you to step in and problem solve for them because they are overwhelmed?
• Do you offer solutions for your mentee's problems because you feel they lack an understanding of the big picture?
• Do you feel obligated to provide a safe space for your mentee to take risks?

You are a coach if you answer ‘yes’ to these questions:

• Do you like to let your mentee do most of the talking while you pinpoint ways to solve their problems?
• Do you find yourself pointing out weak and strong traits in your mentee?
• Are you aiming to help your mentee solve their problems?

You are a connector if you answer ‘yes’ to these questions:

• If you recognize a shortcoming in your mentee, do you try and connect them with experts in that area?
• Do you look for learning opportunities that will benefit your mentee?
• Do you have an extensive network that you can call on to help your mentee develop?

You are a challenger if you answer ‘yes’ to these questions:

• Do you enjoy playing the devil’s advocate to challenge your mentee?
• Do you encourage your mentee to aim high?
• Do you like to push your mentee further to help them develop independence?

You are a clarifier if you answer ‘yes’ to these questions:

• Do you help your mentee learn organizational values and politics?
• Do you allow your mentee to solve their problems?
• Are you slow to offer your opinion on how a mentee should handle a challenge?

You are a sponsor if you answer ‘yes’ to these questions:

• Do you find yourself recommending your mentee for promotion?
• Do you use your network connections to help your mentee get ahead?
• Do you suggest possible career opportunities to your mentee?

You are an affirmer if you answer ‘yes’ to these questions:

• If you see your mentee is worried about something, you spend a lot of time talking about it.
• Do you find yourself having a deep understanding and empathy for your mentee’s situation?
• Are you ready to offer support and a listening ear whenever your mentee stops by?