mentoring.tech: A space for technical mentorship¶
Welcome to mentoring.tech–this is a space dedicated to providing resources to mentors and mentees alike to guide and grow along their techical mentoring journeys.
Table of Contents¶
Resources¶
Contributing¶
Do you want to help contribute to mentoring.tech? Awesome! Here are the most common ways you can contribute:
Adding/Updating Content¶
If you are looking to add content, fix formatting, syntax, typos or other wonderful things, please use the folowing process:
- Install Sphinx: easy_install Sphinx sphinx_rtd_theme or pip install -r requirements.txt
- Fork the repository to your own account
- Check out a branch to make your changes on: git checkout --branch <my_topic>
- Execute make html to build the docs in to _build/
- Make your changes
- Execute make html again and verify your changes don’t cause any warnings/errors
- Commit with a descriptive message, and submit a pull request from your branch to master
- We’ll review the change, and either merge it or provide some feedback. Community review is also encouraged.
A quick note if you’re adding a new heading:
Sphinx will error out if your title text is longer than the title underline. For example: /projects/mentoring.tech/resources.rst:12: WARNING: Title underline too short.
And when you look at the title, you see:
This title is quite long...
-----
Which will cause the error. Corrected, the tite would be more like:
This title is quite long...
-----------------------------------
Which will correct the issue. For any other issues you run into, hop into the Gitter channel and one of us will help out.
