Managing an OSE Project: Difference between revisions

From Open Source Ecology
Jump to navigation Jump to search
No edit summary
Line 1: Line 1:
[[Image:Under_construction_icon.png‎|thumb|This page is under construction]]
{{under construction}}


 
= Overview and Context =
=Overview and Context=


The Open Source Ecology project (OSE) is really a collection of projects, each focused on a task that brings us close to the vision described in the [[OE Proposal]].  Many of these projects will be focused on the [[Global Village Construction Set]], but smaller projects will likely be set up around component development and other tasks.  OSE is in the process of setting up projects for all 50 of the [[GVCS Tools]].  This document and those related to the [[Guide to OSE Projects]] is intended to provide guidelines on how to manage an OSE project.
The Open Source Ecology project (OSE) is really a collection of projects, each focused on a task that brings us close to the vision described in the [[OE Proposal]].  Many of these projects will be focused on the [[Global Village Construction Set]], but smaller projects will likely be set up around component development and other tasks.  OSE is in the process of setting up projects for all 50 of the [[GVCS Tools]].  This document and those related to the [[Guide to OSE Projects]] is intended to provide guidelines on how to manage an OSE project.
Line 10: Line 9:
As the title implies, this document describes how to manage an OSE project.  If you are interested in starting one up, please see [[Starting an OSE Project]].
As the title implies, this document describes how to manage an OSE project.  If you are interested in starting one up, please see [[Starting an OSE Project]].


 
= Roles and Responsibilities =
=Roles and Responsibilities=


Every OSE project is considered a team of people who have come together to design, develop, and build something that furthers the overall goals of OSE whether that is a GVCS machine, a new open source component, or an applications of existing technologies.  Especially for GVCS projects, there are certain well-defined roles taken on by project volunteers.  These include:
Every OSE project is considered a team of people who have come together to design, develop, and build something that furthers the overall goals of OSE whether that is a GVCS machine, a new open source component, or an applications of existing technologies.  Especially for GVCS projects, there are certain well-defined roles taken on by project volunteers.  These include:
Line 28: Line 26:
* Reviewers
* Reviewers


==Project Manager Duties==
== Project Manager Duties ==


The OSE project manager is the key leader of an OSE project.  Duties include:
The OSE project manager is the key leader of an OSE project.  Duties include:
Line 42: Line 40:
See also [[Project Manager Duties]]
See also [[Project Manager Duties]]


==Marketing Specialist Duties==
== Marketing Specialist Duties ==


Ideally, each OSE project (especially the major ones) will have a marketing specialist.  The person is responsible for communicating the worth of this product to the rest of OSE and to the world at large.  The marketing specialist works closely with the project manager to:
Ideally, each OSE project (especially the major ones) will have a marketing specialist.  The person is responsible for communicating the worth of this product to the rest of OSE and to the world at large.  The marketing specialist works closely with the project manager to:
Line 51: Line 49:
* Promote the product for fund raising purposes
* Promote the product for fund raising purposes


==Documentation Specialist Duties==
== Documentation Specialist Duties ==


The project documentation specialist is responsible for creating and maintaining all of the documentation associated with the project which include:
The project documentation specialist is responsible for creating and maintaining all of the documentation associated with the project which include:
Line 62: Line 60:
* Educational materials
* Educational materials


==Subject Matter Expert Duties==
== Subject Matter Expert Duties ==


A subject matter expert (SME) is (as the name implies) an expert in the subject area that the product is based on.  Where more than one technology is used to develop a product, multiple subject matter experts can be brought in.  So, for example, the welding table project might have subject matter experts in welding and numerical control devices.
A subject matter expert (SME) is (as the name implies) an expert in the subject area that the product is based on.  Where more than one technology is used to develop a product, multiple subject matter experts can be brought in.  So, for example, the welding table project might have subject matter experts in welding and numerical control devices.
Line 71: Line 69:
* Review of design and technical materials produced
* Review of design and technical materials produced


==Developer Duties==
== Developer Dutie s==


There are many different kinds of developers that can be associated with a project.  They include CAD designers, product designers, artists, electrical and mechanical engineers, fabricators, makers, programmers, etc.
There are many different kinds of developers that can be associated with a project.  They include CAD designers, product designers, artists, electrical and mechanical engineers, fabricators, makers, programmers, etc.
Line 82: Line 80:
* Communication of completion or development difficulties as they occur.
* Communication of completion or development difficulties as they occur.


==Working with the OSE Core Team==
== Working with the OSE Core Team ==


A high level view of OSE leadership can be viewed in [[Development Team]].  Among these is the "OSE Core Team".  The core team is led by the OSE Executive Director (OSE-ED), currently Marcin Jakubowski who is also the founder of OSE.  Reporting to him are several positions that ensure that the whole OSE project runs smoothly.  These include a Media Director, Resource Director and Donor Relations,  Business Consultant, Operations Manager, and Web Administrator.  These people are there to support the work of the project manager, in addition to other responsibilities.  While they can't do project work for you, they are a resource that can be tapped for ideas, etc.
A high level view of OSE leadership can be viewed in [[Development Team]].  Among these is the "OSE Core Team".  The core team is led by the OSE Executive Director (OSE-ED), currently Marcin Jakubowski who is also the founder of OSE.  Reporting to him are several positions that ensure that the whole OSE project runs smoothly.  These include a Media Director, Resource Director and Donor Relations,  Business Consultant, Operations Manager, and Web Administrator.  These people are there to support the work of the project manager, in addition to other responsibilities.  While they can't do project work for you, they are a resource that can be tapped for ideas, etc.
Line 95: Line 93:
What he doesn't need to hear is all of the fine details going on in your project.  It's too much information.  The OSE Wiki pages are designed to give the Executive Director detailed insight as needed as well as providing information to developers, fabricators, makers, and consumers.  He will be looking at certain pages to get a feel for progress, such as the [[GVCS Tools Status]].  Such pages need to be kept up to date and accurate.
What he doesn't need to hear is all of the fine details going on in your project.  It's too much information.  The OSE Wiki pages are designed to give the Executive Director detailed insight as needed as well as providing information to developers, fabricators, makers, and consumers.  He will be looking at certain pages to get a feel for progress, such as the [[GVCS Tools Status]].  Such pages need to be kept up to date and accurate.


= Managing a Project =


=Managing a Project=
== Delegation and Division of Labor ==
 
==Delegation and Division of Labor==


All of the GVCS projects are too large for one person to design, develop, and build.  With that in mind, the project manager needs to recruit new people to his (or her) team and give them things to do.  When the team is small (3-8), internal project communication can be managed.  As the team grows beyond that, additional organization may need to be added.  To some extent, this is a matter of personal management style:  shallow structures vs. deep ones, report and status styles, hands-on vs. hands-off, etc.  There is plenty of room in OSE product development to accommodate different approaches to product development and team organization.  Ultimately, each OSE project will be judged on it's results:  the product(s) that come out of it.
All of the GVCS projects are too large for one person to design, develop, and build.  With that in mind, the project manager needs to recruit new people to his (or her) team and give them things to do.  When the team is small (3-8), internal project communication can be managed.  As the team grows beyond that, additional organization may need to be added.  To some extent, this is a matter of personal management style:  shallow structures vs. deep ones, report and status styles, hands-on vs. hands-off, etc.  There is plenty of room in OSE product development to accommodate different approaches to product development and team organization.  Ultimately, each OSE project will be judged on it's results:  the product(s) that come out of it.


==The OSE Project Life-Cycle==
== The OSE Project Life-Cycle ==


Here is a diagram from the the OSE [[Development Strategy]]:
Here is a diagram from the the OSE [[Development Strategy]]:
Line 110: Line 107:
Design leads to drawings and material specifications.  These are reviewed and spun out to fabrication bids leading to prototype assembly and testing.  Eventually, the product goes into production.
Design leads to drawings and material specifications.  These are reviewed and spun out to fabrication bids leading to prototype assembly and testing.  Eventually, the product goes into production.


==Key Milestones==
== Key Milestones ==


The following are some of the key milestones in all OSE projects:
The following are some of the key milestones in all OSE projects:
Line 125: Line 122:
Some of these steps may be iterative or broken down into smaller milestones as needed.
Some of these steps may be iterative or broken down into smaller milestones as needed.


==Project Tracking using Pivotal==
== Project Tracking using Pivotal ==


Recently, OSE has started to experiment with a project management application called Pivotal.  This tools has been made available to OSE based on it's non-profit, open source status free of charge.  The [[Pivotal Task Tracker]] allows tasks (stories) to be defined, tracked, and managed using agile development techniques. Our current goal is to import the development steps of the [[GVCS Development Template]] into Pivotal - as tasks that can be taken on by people. The Systems Engineering Breakdown Diagrams should break technologies down into components, so these can be turned into tasks. The key is to break down complex development paths into small chunks - as suggested in [http://opencapitalist.org/content/detailed-open-source-project-creation this important writing].
Recently, OSE has started to experiment with a project management application called Pivotal.  This tools has been made available to OSE based on it's non-profit, open source status free of charge.  The [[Pivotal Task Tracker]] allows tasks (stories) to be defined, tracked, and managed using agile development techniques. Our current goal is to import the development steps of the [[GVCS Development Template]] into Pivotal - as tasks that can be taken on by people. The Systems Engineering Breakdown Diagrams should break technologies down into components, so these can be turned into tasks. The key is to break down complex development paths into small chunks - as suggested in [http://opencapitalist.org/content/detailed-open-source-project-creation this important writing].
Line 139: Line 136:
* [[TRIZ]] - problem solving
* [[TRIZ]] - problem solving


==Documentation Standards==
== Documentation Standards ==


Documentation standards to describe and track OSE projects are still under development.  Only one product has gone through the full project life cycle - the [[CEB Press]], and others have several prototypes - [[LifeTrac]], [[Microtractor]], [[Power Cube]],[[Torch table]] - and are under development.  Have a look at how these pages are organized to get a feel for how to set up OSE project pages.  All GVCS projects should use the [[Product Template]], which is illustrated on [[Torch Table Intro]].  At a minimum, each GVCS project should have the following pages:
Documentation standards to describe and track OSE projects are still under development.  Only one product has gone through the full project life cycle - the [[CEB Press]], and others have several prototypes - [[LifeTrac]], [[Microtractor]], [[Power Cube]],[[Torch table]] - and are under development.  Have a look at how these pages are organized to get a feel for how to set up OSE project pages.  All GVCS projects should use the [[Product Template]], which is illustrated on [[Torch Table Intro]].  At a minimum, each GVCS project should have the following pages:
Line 160: Line 157:
* '''[[Wiki Documentation Standards]]'''
* '''[[Wiki Documentation Standards]]'''


==Team Dynamics==
== Team Dynamics ==


* [[Essay on Creative Problem-Solving]]
* [[Essay on Creative Problem-Solving]]


=Dealing with Volunteers=
= Dealing with Volunteers =


* Recruitment - [[Crowdmap]]
* Recruitment - [[Crowdmap]]
Line 172: Line 169:
** Time management - yours and theirs
** Time management - yours and theirs


 
= Communication =
=Communication=


** Status - what pages need to be updated? [[GVCS Tools Status]]
** Status - what pages need to be updated? [[GVCS Tools Status]]
Line 181: Line 177:
** Describing project needs - [[Project Needs]]
** Describing project needs - [[Project Needs]]


 
= Money Matters =
=Money Matters=


* [[On-Site Fabrication at Factor e Farm]] for bootstrap funding
* [[On-Site Fabrication at Factor e Farm]] for bootstrap funding
Line 194: Line 189:
** Transparency
** Transparency
** Record Keeping
** Record Keeping


= Other Pages =
= Other Pages =
Line 200: Line 194:
[[GVCS Organizational Development Template]]
[[GVCS Organizational Development Template]]


=Outline=
= Outline =


The following topics need to be covered here from a management perspective:
The following topics need to be covered here from a management perspective:

Revision as of 06:19, 10 June 2011

Under construction icon.png This page is currently under construction and might undergo drastic changes within a short span of time.


Overview and Context

The Open Source Ecology project (OSE) is really a collection of projects, each focused on a task that brings us close to the vision described in the OE Proposal. Many of these projects will be focused on the Global Village Construction Set, but smaller projects will likely be set up around component development and other tasks. OSE is in the process of setting up projects for all 50 of the GVCS Tools. This document and those related to the Guide to OSE Projects is intended to provide guidelines on how to manage an OSE project.

It is important to understand that OSE embraces Open Source Development, which means that many of the people working on OSE projects are volunteers donating their time, money, and labor to something that they believe in. The principles of open source have an impact on how open source projects are run. Transparency is important. The voluntary contributions of labor, time, and money influence how things can be done and how fast things can be done. Care must be taken with the intellectual property contributed to OSE. Even open source must be protected against those who might take it and lock it up (via patents, for example).

As the title implies, this document describes how to manage an OSE project. If you are interested in starting one up, please see Starting an OSE Project.

Roles and Responsibilities

Every OSE project is considered a team of people who have come together to design, develop, and build something that furthers the overall goals of OSE whether that is a GVCS machine, a new open source component, or an applications of existing technologies. Especially for GVCS projects, there are certain well-defined roles taken on by project volunteers. These include:

  • Project Manager and Sub-project Team Leaders
  • CAD Designers
  • Prototypers and Fabricators
  • Marketing Specialists and Fundraisers
  • Recruitment
  • Power Electronics Developers
  • Mechanical Engineers
  • Software Engineers
  • Metallurgists
  • Documentation Specialists and Videographers
  • Subject Matter Experts
  • Reviewers

Project Manager Duties

The OSE project manager is the key leader of an OSE project. Duties include:

  • Develop a plan and guide it's execute towards developing and delivering an OSE product.
  • Lead volunteers in the tasks needed to develop a product.
  • Recruit volunteers as needed.
  • Communicate project status through the wiki, forums, blog, and other channels.
  • Work with the OSE Director to coordinate this project with other OSE projects.
  • Ensure high quality product documentation that abides by OSE specifications.
  • Take responsibility for any money transactions that may be required.

See also Project Manager Duties

Marketing Specialist Duties

Ideally, each OSE project (especially the major ones) will have a marketing specialist. The person is responsible for communicating the worth of this product to the rest of OSE and to the world at large. The marketing specialist works closely with the project manager to:

  • Develop and deliver product-oriented documentation and literature
  • Develop and deliver promotional material including web pages, blogs, announcements, press releases, photos, videos, etc.
  • Promote the product for recruitment purposes
  • Promote the product for fund raising purposes

Documentation Specialist Duties

The project documentation specialist is responsible for creating and maintaining all of the documentation associated with the project which include:

  • Research notes and links
  • All technical documentation
  • Fabrication notes, photos, and videos
  • Descriptions, photos, and videos of the product in use
  • Marketing materials
  • Educational materials

Subject Matter Expert Duties

A subject matter expert (SME) is (as the name implies) an expert in the subject area that the product is based on. Where more than one technology is used to develop a product, multiple subject matter experts can be brought in. So, for example, the welding table project might have subject matter experts in welding and numerical control devices.

Duties of the SME include:

  • Technical guidance and advice
  • Review of design and technical materials produced

Developer Dutie s

There are many different kinds of developers that can be associated with a project. They include CAD designers, product designers, artists, electrical and mechanical engineers, fabricators, makers, programmers, etc.

Developer duties include:

  • Work with the project manager to communicate availability
  • Completion of work tasks in a timely manner
  • Working with the process tools developed by OSE, such as Pivotal for project tracking
  • Communication of completion or development difficulties as they occur.

Working with the OSE Core Team

A high level view of OSE leadership can be viewed in Development Team. Among these is the "OSE Core Team". The core team is led by the OSE Executive Director (OSE-ED), currently Marcin Jakubowski who is also the founder of OSE. Reporting to him are several positions that ensure that the whole OSE project runs smoothly. These include a Media Director, Resource Director and Donor Relations, Business Consultant, Operations Manager, and Web Administrator. These people are there to support the work of the project manager, in addition to other responsibilities. While they can't do project work for you, they are a resource that can be tapped for ideas, etc.

At this time, all OSE project managers report to the OSE Executive Director (Marcin). This is likely to change over time since no one can easily direct the efforts of fifty separate (and interconnected) projects. The following things should be communicated to the Executive Director:

  • Major milestones accomplished
  • Major problems that have come up
  • Conflicts with other projects
  • Money related matters (TBD)

What he doesn't need to hear is all of the fine details going on in your project. It's too much information. The OSE Wiki pages are designed to give the Executive Director detailed insight as needed as well as providing information to developers, fabricators, makers, and consumers. He will be looking at certain pages to get a feel for progress, such as the GVCS Tools Status. Such pages need to be kept up to date and accurate.

Managing a Project

Delegation and Division of Labor

All of the GVCS projects are too large for one person to design, develop, and build. With that in mind, the project manager needs to recruit new people to his (or her) team and give them things to do. When the team is small (3-8), internal project communication can be managed. As the team grows beyond that, additional organization may need to be added. To some extent, this is a matter of personal management style: shallow structures vs. deep ones, report and status styles, hands-on vs. hands-off, etc. There is plenty of room in OSE product development to accommodate different approaches to product development and team organization. Ultimately, each OSE project will be judged on it's results: the product(s) that come out of it.

The OSE Project Life-Cycle

Here is a diagram from the the OSE Development Strategy:

Collaboration procedure.jpg

Design leads to drawings and material specifications. These are reviewed and spun out to fabrication bids leading to prototype assembly and testing. Eventually, the product goes into production.

Key Milestones

The following are some of the key milestones in all OSE projects:

  1. Product Description and Rationale
  2. Design and Specification
  3. Part Sourcing and Build Instructions
  4. Design Review
  5. Fabrication
  6. Prototype Assembly and Testing
  7. Full Fab/Assembly Documentation
  8. Production

Some of these steps may be iterative or broken down into smaller milestones as needed.

Project Tracking using Pivotal

Recently, OSE has started to experiment with a project management application called Pivotal. This tools has been made available to OSE based on it's non-profit, open source status free of charge. The Pivotal Task Tracker allows tasks (stories) to be defined, tracked, and managed using agile development techniques. Our current goal is to import the development steps of the GVCS Development Template into Pivotal - as tasks that can be taken on by people. The Systems Engineering Breakdown Diagrams should break technologies down into components, so these can be turned into tasks. The key is to break down complex development paths into small chunks - as suggested in this important writing.

All of the OSE projects are public to view, but you must be a team member to enter new stories or work on a task. To see the public OSE projects link to [1] and search for "OSE".

The GVCS Tools Status is also something of a management tool since it rolls up much of the status and high level progress of the various projects. You can more or less see what projects are active and what is being worked on (provided this page is maintained).

Documentation Standards

Documentation standards to describe and track OSE projects are still under development. Only one product has gone through the full project life cycle - the CEB Press, and others have several prototypes - LifeTrac, Microtractor, Power Cube,Torch table - and are under development. Have a look at how these pages are organized to get a feel for how to set up OSE project pages. All GVCS projects should use the Product Template, which is illustrated on Torch Table Intro. At a minimum, each GVCS project should have the following pages:

  • Intro
  • Development process
  • Bill of Materials
  • Build Instructions
  • Buy It!
  • User's Manual

Note: Marcin would eliminate the Buy It until AFTER clarity is attained on: the OSE Label, OSE Specifications, Fabricator Training, Product Standards and Testing, License - and other fundamentals of Distributive Enterprise creation. We are setting new standards for distributive enterprise, and this should not be taken lightly.

This organization is being discussed at the current time (June 2011) and may be revised in the future.

The Wiki_Templates describes the only real standard we have for project documentation at this time by the core team back in January, 2011 (Marcin, Isaiah, Floyd in a face-to-face meeting). Other templates have been proposed independently of the core team since then, and much confusion has arisen as many people joined development efforts. Mark Norton has proposed expanding the tool template to include pages for an Overview, Research, Design, Development, Specifications, Bill of Materials, Build Instructions, How to Buy, and a User Manual. See Mark J Norton/GVCS Template for details but be aware that this is NOT an adopted OSE standard.

Other pages related to project documentation include:

Team Dynamics

Dealing with Volunteers

  • Recruitment - Crowdmap
    • Recruiting People
    • Keeping people on task and focused
    • Disruptive or Harmful Behaviors
    • Time management - yours and theirs

Communication

Money Matters

    • Raising Funds
    • Keeping Track of Money
    • Transparency
    • Record Keeping

Other Pages

GVCS Organizational Development Template

Outline

The following topics need to be covered here from a management perspective:

  • Starting an OSE Project
  • Roles and Responsibilities
    • Project Roles
    • Project Manager Responsibilities
    • Other Key Roles and what they do
    • Relationship to OSE Core Team - Development Team
  • Dealing with Volunteers
    • Recruiting People
    • Keeping people on task and focused
    • Disruptive or Harmful Behaviors
    • Time management - yours and theirs
  • Communication
  • Managing the Project
  • Money Matters
    • Raising Funds
    • Keeping Track of Money
    • Transparency
    • Record Keeping