#128 Outreachy proposal: Improve Docs Experience
Closed: fixed 2 years ago by riecatnor. Opened 2 years ago by bcotton.

  • One-line name
    Improve Docs Experience
  • Longer description of project
    Fedora's documentation website has grown organically over the years. As a result, the content and layout isn't always intuitive. In this project, you will work with the Docs teams to improve how the content is organized and displayed in order to make our documentation more discoverable.
  • License of the project
    CC BY-SA 4.0
  • Longevity (How long has the team accepted contributions)
    19 years
  • Community size
    Docs team has ~10 contributors
  • How will this project benefit Fedora
    This project will enable Fedora contributors and users to more easily find the information they are looking for.
  • Sample plan of work for the 12 week internship. What are milestones the
    intern should be hitting? This doesn't need to be incredibly detailed and
    can change later but there needs to be a general breakdown of tasks.
    1. Familiarize with tooling and community
    2. Re-design docs front page
    3. Make additional navigation and content changes to user docs
    4. Provide suggestions to contributor teams for their docs layouts
  • Benefits to intern (What will the intern get out of this internship)
    The intern will have the ability to make a meaningful difference in user and contributor experience for a large open source project.
  • Project website
    https://docs.fedoraproject.org
  • Project repo
    https://pagure.io/fedora-docs/docs-fp-o
  • Where can an applicant find application tasks?
    https://pagure.io/fedora-docs/docs-fp-o
  • IRC
    #fedora-docs
  • Skills required including what level and if they are optional
    • Technical writing
    • Information cataloging/library science
    • UI/UX design
    • Basic HTML and CSS
    • Git (we'll teach you)
    • Asciidoc/Antora (we'll teach you)
  • Outreachy applicants are required to make a contribution as part of the
    application. What is the process for making a contribution?
    Applicants will make change proposals for the Docs front page (via pull request or sample page)

Questions from the top level Outreachy Program for the mentor application:
- How long have you been contributing to the community:
12 years
- What is your current role
Program Manager
- Have you mentored for a three-month internship program before
Yes
- Have you read the mentor page and understand the process of being a mentor
Yes
- Are you available for 5 hours a week during the internship period
Yes
- Are you available for 5-10 hours a week during the application period
Yes
- Are you aware you need to sign a mentor contract
Yes


(I'll be on PTO until Thursday, so if you have follow-up questions I probably won't be able to answer them)

Hi Ben
the project looks good to me
Since you are not around, and the last day to get the project in outreachy system is tomorrow, I would enter it on your behalf and when you are here, will add you as the mentor

Metadata Update from @t0xic0der:
- Issue tagged with: Outreachy, project-idea

2 years ago

Hi Ben, I added the project to the outreachy website with me as a mentor.
Once you select the option to co-mentor this, I will withdraw my name making you the only mentor.

How to apply as a co-mentor:
Go to https://www.outreachy.org/communities/cfp/fedora/ after logging in the outreachy website
At the bottom of the web page, you would see "Select a project to co-mentor" Click on the project name.
It will take you to the page where you will have to enter a few details :)
let me know if you have any questions

Metadata Update from @riecatnor:
- Issue close_status updated to: fixed
- Issue status updated to: Closed (was: Open)

2 years ago

Login to comment on this ticket.

Metadata