Draft proposal, until agreed on and joined by members from at least three Samvera Partners.Meeting every other Wednesday at 4pm Eastern. Email email@example.com for a calendar invite.
Scope & Objectives
The Developer Onboarding Working Group is interested in creating will:
Create documentation and other resources
designed to help Samvera development teams onboard a developer who has no Samvera experience.
Create plans to ensure this documentation can stay up-to-date via scheduled reviews and updates.
Multiple teams have gone through the challenges of onboarding developers. This working group will draw on those efforts to create a body of resources for this task. To that end, the group may work on some of the following, or come up with other ideas:
Collect information on strategies that help;
Create a curriculum to guide the learning process;
Create an inventory of resources that are currently available, such as the new Samvera Q&A sessions, the Developer Congresses, and mentor program;
Update architecture diagrams;
Document important things to know about the code;
Collect links to external resources such as tutorials and blogs;
potentially document tips from experienced developers.
To achieve these goals, it would probably be helpful for this working group to should include supervisors who have faced the challenge of developer onboarding as well as senior developers on whose shoulders this task has fallen in the past; new developers could also help significantly in the identification of pain points. And as always, the group will welcome anyone who thinks this work is important and is willing to help complete it.
Deliverables & Timeframe
The deliverable will be online documentation and resources to facilitate onboarding a development team member, and maintenance plans for these resources. These will be discoverable from the Samvera wiki.A second deliverable will be a proposal on how to maintain this information current.
The group will plan to complete this work by the end of 2021 or maybe until Spring of 2022 -- depending on how deep the group accepts to go with the begin work in March 2022, and scope the timeframe for this work.
Meeting Times & Communication Channels
On the agenda of the first meeting, which will be scheduled following a doodle poll made available to interested community members, will be the decision about meeting frequency and meeting schedule. The group will use the existing Samvera communication channels such as mailing lists and slack channels.
Note that Working Groups must have participants from three different Partners. All members of a working group producing software must be licensed Samvera contributors covered by the appropriate CLAs. Other types of contributions such as requirements, design, best practices, documentation, etc. - do not require CLAs but participants should accept that the materials to which they contribute may be released under a Creative Commons Attribution 4.0 International License..
Heather Greer Klein , Facilitator (Samvera)
bess (Princeton University)
Juliet Hardesty (Indiana University)
tamsin johnson (UCSB)
Kait Sewell (Scientist.com)
your name here (your institution hereKiah Stroud (Scientist.com)