#117 How to create on-boarding guidelines for your team
Opened 2 years ago by bee2502. Modified 2 years ago

It was decided in CommOps meeting on 2017-09-13, that CommOps would work towards an integrated document to guide different teams on how-to create effective onboarding guidelines and provide them with examples.

More Info here -
https://meetbot.fedoraproject.org/fedora-meeting/2017-09-13/commops.2017-09-13-17.05.log.html

Roadmap for this ticket -
Close all tickets related to working with each sub-project on on-boarding improvements; instead, work to create (1) howto doc on creating good on-boarding guidelines for team, and (2) CommOps on-boarding guidelines in new doc site; then, writing article / share across Fedora about this, explain why, try to get sub-projects to add their own guidelines


Metadata Update from @bee2502:
- Issue tagged with: meeting, needs feedback, onboarding

2 years ago

Metadata Update from @jflory7:
- Issue untagged with: meeting, needs feedback
- Issue assigned to jflory7
- Issue marked as depending on: #118
- Issue marked as depending on: #122
- Issue priority set to: normal (1-2 weeks)
- Issue set to the milestone: Fedora 28 (to May 2018)

2 years ago

Discussed in 2017-10-30 meeting.

Next step: Porting our docs

The next best step is to port some of our static wiki content over to a Fedora Docs-style publication. The blocker for this work is #123 (@bex is working on this, will be finished soon). Then, ticket #118 details the work needed to port over more of our own wiki documentation. An example of a specific page is #122.

Once #118 is closed, we will spend time documenting our process for migrating wiki pages to documentation and help other teams / sub-projects with this work. Until then, removing the meeting tag from this ticket and will follow up once we are farther along with our documentation.

Metadata Update from @jflory7:
- Issue unmarked as blocking: #34

2 years ago

Metadata Update from @jflory7:
- Assignee reset

2 years ago

Metadata Update from @jflory7:
- Issue priority set to: no deadline (was: normal (1-2 weeks))
- Issue tagged with: meeting

2 years ago

Metadata Update from @jflory7:
- Issue untagged with: meeting
- Issue tagged with: help wanted

2 years ago

Fedora 28 milestone deadline

This issue is tagged for completion during the Fedora 28 (F28) milestone. The F28 milestone ends on Tuesday, May 1, 2018. This issue will be bumped to the Fedora 29 release cycle.

Metadata Update from @jflory7:
- Issue priority set to: minor (3-4 weeks) (was: no deadline)
- Issue set to the milestone: Fedora 29 (to Oct. 2018) (was: Fedora 28 (to May 2018))

2 years ago

Metadata Update from @jflory7:
- Issue priority set to: normal (1-2 weeks) (was: minor (3-4 weeks))

2 years ago

Metadata Update from @jflory7:
- Issue tagged with: next meeting

2 years ago

Metadata Update from @jflory7:
- Issue tagged with: docs

2 years ago

Discussed in 2018-04-30 meeting.


Next steps

The next step is to file smaller sub-tickets to accomplish this larger goal of a general team onboarding guide / reference for other sub-projects and Fedora teams. In our meeting, we identified the immediate next step to review and research how other sub-projects bring in new contributors today, and look for common characteristics across existing content.

Content for different audiences

In the meeting, @dhanesh95 mentioned the idea of splitting content between types of teams, like outreach and development teams. We agreed that we can add a subheading or extra section with specific tips to the general document (e.g. Advice for programming language SIGs), and if we end up with more specific content than we expected, we can create new documents.¹

¹ Possibly a cool opportunity to try out modular docs with <include> blocks…

Background context

The deliverable is write effective guidelines on how to on-board someone to a Fedora sub-project or team. The guidelines offer suggested best practices and helpful steps for any sub-project to follow (e.g. using Pagure issue labels, mailing list introduction templates, etc.).

This is a different approach than we took before. A long time ago, we tried to create new onboarding guidelines for every major sub-project in Fedora ( #34 / #60 ). This was an ambitious goal and we were unable to complete it. This approach of a single, general document offers the best use of time for the largest impact on the community. By writing a general list of tips and best practices for sub-project onboarding, many teams can start from a general base and "shape" the guidelines to meet the specific needs of their teams.

Splitting up tasks

I am actioned to split this ticket into smaller sub-tickets. I will work on that this week.

Metadata Update from @jflory7:
- Issue untagged with: next meeting

2 years ago

sub-tickets

#168
#167
#166
#165

Maybe we need more sub-tickets

@bt0dotninja ¡Gracias Alberto! Thanks for taking the time to split this ticket up into smaller tasks. We can carry out further discussion in those tickets.

I did create a public pad[1] to work all the related tickets, some has good comments that works as starting point for a brainstorming :smiley:

[1] https://etherpad.gnome.org/p/CommOps-OnBoarding-Series

@bt0dotninja The best place to start is probably with research. We can open a call for contributions on #165. I may have time to work on it after I get through the FAW announcement and Flock recap CommBlog posts, but I don't have bandwidth for it yet.

Metadata Update from @jflory7:
- Issue priority set to: waiting on external (was: next meeting)
- Issue set to the milestone: Fedora 30 (to May 2019) (was: Fedora 29 (to Oct. 2018))

2 years ago

Login to comment on this ticket.