OSE Documenter Job Description: Difference between revisions

From Open Source Ecology
Jump to navigation Jump to search
No edit summary
No edit summary
Line 5: Line 5:
The Open Source Economy is the next trillion dollar economy, and we intend to bring it to the world sooner with your help. We’re looking for a professionals with Documentation, Writing, Video Editing, Publishing, and Copywriting skills to play a role in documentation and publishing. As an education organization, our key product is documentation - of the machines, skills, and techniques that we develop.  
The Open Source Economy is the next trillion dollar economy, and we intend to bring it to the world sooner with your help. We’re looking for a professionals with Documentation, Writing, Video Editing, Publishing, and Copywriting skills to play a role in documentation and publishing. As an education organization, our key product is documentation - of the machines, skills, and techniques that we develop.  


The Documentation Team works closely with and as part of our core Development Team. Development work focuses on design - and Documenters assist in our open source product development efforts by publishing instructionals on both the development process and the technologies under development. We focus on open source appropriate technology and the development of regenerative economies. Documentation plays a key role in replication of our work worldwide.  This offer is a generalist position, with promotion track to VP of Documentation.  
The Documentation Team works closely with and as part of our core Development Team. Development work focuses on design - and Documenters assist in our open source product development efforts by publishing instructionals on both the development process and the technologies under development. We focus on open source appropriate technology and the development of regenerative economies. Documentation plays a key role in replication of our work worldwide, in sharing our story with the rest of the world, and helps to market our message to adopters and new developers.  This offer is a generalist position, with promotion track to VP of Documentation.  


Documentation Team Duties:
Documentation Team Duties:
Line 12: Line 12:
*Learning Kdenlive - the open source nonlinear video editor - to produce short but information-rich and impactful instructional videos
*Learning Kdenlive - the open source nonlinear video editor - to produce short but information-rich and impactful instructional videos
*Writing scripts for instructional videos, such as build instructionals, big-picture story-telling shorts, and other educational and edu-marketing materials.
*Writing scripts for instructional videos, such as build instructionals, big-picture story-telling shorts, and other educational and edu-marketing materials.
*Learning basic proficiency in FreeCAD - the open source video editing package. Most of our workflows revolve around FreeCAD, and a number of workflows that needs to be documented involves FreeCAD - such that basic literacy in FreeCAD is indispensible to producing and testing instructionals.
*Learning basic proficiency in FreeCAD - the open source video editing package. Most of our workflows - and therefore many of our documentation needs - revolve around FreeCAD. Basic literacy in FreeCAD is indispensable to the Documenter's skill set - such as for: manipulating 3D designs; producing and testing instructionals; for producing other documentation assets
*Downloading and using OSE Linux Live USB  - a free operating system featuring critical software packages used throughout OSE's development work. We require this so everyone has access to a suite of preinstalled software, thereby eliminating software + file compatibilty issues for seamless development
*Downloading and using OSE Linux Live USB  - a free operating system featuring critical software packages used throughout OSE's development work. We require this so everyone has access to a suite of preinstalled software, thereby eliminating software + file compatibilty issues for seamless development
*Participation in a weekly Development Team meeting to coordinate with team members on  
*Participation in a weekly Development Team meeting to coordinate with team members on  
Line 18: Line 18:
*Composing publications, such as Design Guides and Construction Set how-tos - which enable others to get more involved in   
*Composing publications, such as Design Guides and Construction Set how-tos - which enable others to get more involved in   
*Working directly with OSE Developers to produce  
*Working directly with OSE Developers to produce  
*Working with the rest of the development team to create, improve, and test  for effective documentation
*Keep an ongoing work log, filling a weekly timesheet, documenting work product openly, and publishing results early and often using publically-accessible and open document formats -  so that a larger global collaboration team has ready access to all work that is done via a team effort
*Assisting team members in improving their documentation processes
*Interviewing other team members for the purposes of producing various instructionals and video content
*Coordinate with IT Generalist on filling gaps in IT infrastructure related to the Documentation function, such as updating the OSE Linux with new documentation software.
*Continuous quality improvement of the Documentation process to optimize team morale, effectiveness and efficiency
*Setting specific recruiting velocity milestones on a monthly basis, with a an average goal of 1-2 new developers joining the team per week
*Logging all work product in a Work Log on the OSE wiki, and filling out a weekly Time Sheet
*Participate in continuing learning opportunities related to OSE's open source product development method


Requirements:
Requirements:


*We are looking for candidates who have an insatiable appetite for learning, who are effective communicators, have good technical competency, and who thrive in a dynamic learning environment.
*We are looking for candidates who have an insatiable appetite for learning, who are effective communicators, have good technical competency, and who thrive in a dynamic learning environment of team players.
*Willingness to learn various open source software packages related to documenting open product design
*Both technical and creative writing skills, as well as copywriting skills, are useful in this role
*This offer is for a 90 day development cycle duration, at which point the candidate has a chance to renew their commitment
*This offer is for a 90 day development cycle duration, at which point the candidate has a chance to renew their commitment
*A minimum of 10 hours of volunteer time is required per week, as we require a serious commitment from our participants and pride ourselves on rapid and visible results
*A minimum of 10 hours of volunteer time is required per week, as we require a serious commitment from our participants and pride ourselves on rapid and visible results
Identifying short-term contributors for external reviews, curriculum development, and webinar presentations
On-boarding and off-boarding of contributors
Maintaining and updating a list of training resources, including recruiting contributors to assist in the creation of training materials
Coordinating with Development Team leads on team staffing needs to fill any gaps in the Development Team
Video recording of initial interview and uploading to YouTube as private records for quality control purposes
Assisting the Heavyweight Product Manager in the creation of systems for scaling HR efforts for improved development velocity
Documenting all HR protocols as publicly-acessible documents, restricting viewing access only to sensitive information
Coordinate with IT Generalist on filling gaps in IT infrastructure related to the HR function
Maintaining a Development Team profile page on the OSE wiki to show current and past developer profiles, including listing contributors' skills badges
Maintaining analytics on contributor hours, retention rates, recruiting velocity, and HR effort.
Helping to define metrics and incentives for contributors
Continuous quality improvement of the recruiting process to optimize team morale, effectiveness and efficiency
Setting specific recruiting velocity milestones on a monthly basis, with a an average goal of 1-2 new developers joining the team per week
Logging all work product in a Work Log on the OSE wiki, and filling out a weekly Time Sheet
Participate in continuing learning opportunities related to OSE's open source product development method

Revision as of 23:52, 27 March 2017

Open Source Software has changed the world by presenting the world with options. We believe that Open Hardware will do the same by giving people access to resources and materials to change their lives through Open Source appropriate technology. Want to change the world with us?

See what we do in the Founder's TED Talk - http://bit.ly/2kyYsvn

The Open Source Economy is the next trillion dollar economy, and we intend to bring it to the world sooner with your help. We’re looking for a professionals with Documentation, Writing, Video Editing, Publishing, and Copywriting skills to play a role in documentation and publishing. As an education organization, our key product is documentation - of the machines, skills, and techniques that we develop.

The Documentation Team works closely with and as part of our core Development Team. Development work focuses on design - and Documenters assist in our open source product development efforts by publishing instructionals on both the development process and the technologies under development. We focus on open source appropriate technology and the development of regenerative economies. Documentation plays a key role in replication of our work worldwide, in sharing our story with the rest of the world, and helps to market our message to adopters and new developers. This offer is a generalist position, with promotion track to VP of Documentation.

Documentation Team Duties:

  • Work with the Development Team of OSE Developers to document development processes and the technologies under development with a focus on making our designs and processes transparent to the general public
  • Learning Kdenlive - the open source nonlinear video editor - to produce short but information-rich and impactful instructional videos
  • Writing scripts for instructional videos, such as build instructionals, big-picture story-telling shorts, and other educational and edu-marketing materials.
  • Learning basic proficiency in FreeCAD - the open source video editing package. Most of our workflows - and therefore many of our documentation needs - revolve around FreeCAD. Basic literacy in FreeCAD is indispensable to the Documenter's skill set - such as for: manipulating 3D designs; producing and testing instructionals; for producing other documentation assets
  • Downloading and using OSE Linux Live USB - a free operating system featuring critical software packages used throughout OSE's development work. We require this so everyone has access to a suite of preinstalled software, thereby eliminating software + file compatibilty issues for seamless development
  • Participation in a weekly Development Team meeting to coordinate with team members on
  • Producing compact video instructionals for the Development Team to help onboard new developers and to teach new skills to existing members
  • Composing publications, such as Design Guides and Construction Set how-tos - which enable others to get more involved in
  • Working directly with OSE Developers to produce
  • Working with the rest of the development team to create, improve, and test for effective documentation
  • Keep an ongoing work log, filling a weekly timesheet, documenting work product openly, and publishing results early and often using publically-accessible and open document formats - so that a larger global collaboration team has ready access to all work that is done via a team effort
  • Assisting team members in improving their documentation processes
  • Interviewing other team members for the purposes of producing various instructionals and video content
  • Coordinate with IT Generalist on filling gaps in IT infrastructure related to the Documentation function, such as updating the OSE Linux with new documentation software.
  • Continuous quality improvement of the Documentation process to optimize team morale, effectiveness and efficiency
  • Setting specific recruiting velocity milestones on a monthly basis, with a an average goal of 1-2 new developers joining the team per week
  • Logging all work product in a Work Log on the OSE wiki, and filling out a weekly Time Sheet
  • Participate in continuing learning opportunities related to OSE's open source product development method

Requirements:

  • We are looking for candidates who have an insatiable appetite for learning, who are effective communicators, have good technical competency, and who thrive in a dynamic learning environment of team players.
  • Willingness to learn various open source software packages related to documenting open product design
  • Both technical and creative writing skills, as well as copywriting skills, are useful in this role
  • This offer is for a 90 day development cycle duration, at which point the candidate has a chance to renew their commitment
  • A minimum of 10 hours of volunteer time is required per week, as we require a serious commitment from our participants and pride ourselves on rapid and visible results