[of-dev] towards openFrameworks "teams" and "projects"

Kyle McDonald kyle at kylemcdonald.net
Wed Jan 7 14:07:11 PST 2015

if people feel that their idea isn't necessarily already supported by the
community, then yes, it's great that they start in their own account or
fork because the most important thing is to "just get started". we can
always move things around.

on the other hand, here are a few examples of projects that everyone knew
were essential from the beginning:

- apothecary could have started as a repo under the OF organization.
- ofSketch would make sense as an OF repo, but that decision is up to olab
- zach said this week he will create a repo for the project generator that
puts all the separate pg work in one place
- the 64-bit and c++11 work could have been done in a branch
- the early RPi work could have been done in a branch

in short: feel free to use OF as much as you can when you think it will
help bring people together.

On Wed, Jan 7, 2015 at 10:32 AM, Elliot Woods <elliot at kimchiandchips.com>

> one issue with that is that people can't just 'get started' with the
> project
> which seems to be the usual pattern
> (somebody starts firing on a project all of a sudden, and then it gathers
> interest)
> so the model there would need to accommodate for people starting
> 'off-piste' and then bringing their fork into the oF repo as it became an
> 'officially ratified' project
> rather than waiting for official ratification before the project even
> begins (which would kill off a lot of the interesting efforts which spring
> up)
> which would commonly be the case if projects are to always begin in the
> main repo
> elliot
> On 6 January 2015 at 21:05, Kyle McDonald <kyle at kylemcdonald.net> wrote:
>> in the past, projects have started by people creating private repos that
>> either fork OF or start something new completely. then that project is
>> managed with its own issue tracking, and eventually merged with a single
>> big PR.
>> in the future, i'd like to see more branches of the openframeworks repo,
>> or even repos under the openframeworks organization, but only because i
>> want people to feel that the work they're doing is "official" and has our
>> support.
>> for smaller projects that don't demand an entire repo or branch, a
>> combination of 1 and 3 (tags plus main/sub issues) are great. this is the
>> way apothecary is working right now, even though it started as its own
>> repo. checklists have also been working well.
>> i'd like to avoid the hackpad solution, because it's harder to keep track
>> of (only because it's not in the same place as the issues, and you can't
>> see a progress bar on checklists), but for the ofDoc roadmap it hasn't been
>> a problem.
>> in short: whatever works, but everyone should feel free to use the
>> openframeworks organization.
>> On Sun, Jan 4, 2015 at 12:18 PM, Elliot Woods <elliot at kimchiandchips.com>
>> wrote:
>>> Hey Kyle, all
>>> Thank you for continuing to spend time to improve the way the group
>>> coordinates and communicates.
>>> This development is welcome and I look forwards to the 'project basis'
>>> development getting strengthened.
>>> What is the best way to centrally coordinate a project?, e.g.:
>>> 1. A main github issue, with subissues
>>> 2. A hackpad, with a number of github issues
>>> 3. A github tag, shared by a set of github issues
>>> the most automated is 3.
>>> i think 1 makes the most sense given the 'energy drive' around a project
>>> (including the conversations which tail-off in different directions)
>>> Elliot
>>> On 30 December 2014 at 19:16, Kyle McDonald <kyle at kylemcdonald.net>
>>> wrote:
>>>> hi everyone,
>>>> - - -- short version
>>>> we're moving away from the "section leader" role, towards "teams" and
>>>> "projects":
>>>> - teams: one or more people generally interested in helping with a
>>>> section (think "android")
>>>> - projects: a specific effort with goals and timeline (this "c++11" or
>>>> "docs")
>>>> how is this different than what we're doing now? it's not! most of the
>>>> community structure for openFrameworks is descriptive (we try to find a way
>>>> to describe the best parts of what is naturally happening) rather then
>>>> prescriptive (telling people how to collaborate). and hopefully with better
>>>> understanding, we can collaborate more effectively.
>>>> - - -- long version
>>>> back in december 2009, openFrameworks was moved from a private svn to
>>>> github. two years later, in december 2011, we introduced the idea of
>>>> "section leaders" to the openFrameworks community [0] and later we put some
>>>> documents on the wiki to try and formalize the contribution process [1][2]
>>>> three years later, we've learned a lot about what does and doesn't work
>>>> when a distributed group of volunteers comes together to develop a creative
>>>> coding toolkit.
>>>> the model we've been using until now is "section leaders". in theory, a
>>>> section leader is someone who has interest and possibly expertise in
>>>> guiding a subsection of openFrameworks, anything from "documentation" to
>>>> "outreach" or "iOS". they have the access to any accounts or repositories
>>>> they need, freedom (within guidelines) to commit and merge changes, and a
>>>> responsibility to keep up with the discussion on any related features and
>>>> issues.
>>>> for a couple people this model has worked really well, but for everyone
>>>> else there has been some problems with this approach:
>>>> - the exact responsibilities are ambiguous, some people feel guilty
>>>> they aren't "leading" enough
>>>> - there is no clear term, or endpoint, or way to "finish" a job as a
>>>> section leader, and a stigma around leaving [3]
>>>> - having just one leader per section creates an unfair burden for that
>>>> person in a project as active as openFrameworks
>>>> - people with interests already covered by a section leader avoid
>>>> taking initiative when they think they might be stepping on someone else's
>>>> feet [4]
>>>> with these things in mind, i started a discussion with zach, theo, and
>>>> arturo in november about another direction to go. we spoke with all the
>>>> section leaders, and it seems like the right move: we're going to break the
>>>> "section leader" role into "teams" and "projects". here's an initial
>>>> description:
>>>> - teams are meant to be very fluid. they're focused on a section.
>>>> people can be in as many teams as they think they can contribute to. you
>>>> will have access to any accounts or repos you need, but are also expected
>>>> to contribute to discussions, and remove yourself from the team if you
>>>> don't expect to be able to contribute for a while. we're happy to add and
>>>> remove anyone who has interest, and would hope team members can mentor each
>>>> other. github also has a great mechanism allowing you to @mention teams by
>>>> saying (for example) @openframeworks/ios and everyone on that team gets an
>>>> email. the more we use this, the less it has to be about any specific
>>>> person, and it can be more about anyone who has time.
>>>> - projects are just a name for things like linux arm, c++11, 64-bit,
>>>> halfdanj's "docs" work, the current apothecary drive for complete coverage,
>>>> workergnome's multilingual work, etc. projects usually form when one or
>>>> more people [5] show interest in developing a complex new feature or taking
>>>> OF in some new direction. it's almost always that this is where the real
>>>> "leadership" emerges, and people make plans, goals, timelines, etc. we want
>>>> to recognize this more "officially", and keep up good communication to keep
>>>> these projects flowing :)
>>>> with that said, the next steps are:
>>>> 0. does this make sense? is this a more accurate description of what's
>>>> happening, and a useful direction to head?
>>>> 1. we need to fill out the wiki with slight revisions to the
>>>> "Code-Contribution-Workflow" and "Pull-Request-Review-Procedure" pages to
>>>> change the language.
>>>> 2. a bunch of people are already making regular contributions to
>>>> different sections, but aren't necessarily on a team yet. we'd like to add
>>>> you! please get in touch :)
>>>> 3. we should change the OF website to reflect this new structure. i've
>>>> attached a screenshot of what i imagine the "contributors" section might
>>>> look like. it's mostly generated by a script pulling from github, i
>>>> sincerely apologize if i've overlooked something. i'd love some feedback
>>>> before i merge the pr! [6]
>>>> thanks again to everyone who continues to make openFrameworks awesome!
>>>> kyle
>>>> [0] http://forum.openframeworks.cc/t/call-for-leaders/8391
>>>> [1]
>>>> https://github.com/openframeworks/openFrameworks/wiki/Code-Contribution-Workflow
>>>> [2]
>>>> https://github.com/openframeworks/openFrameworks/wiki/Pull-Request-Review-Procedure
>>>> [3] stigma about leaving is a big problem in oss in general, and
>>>> something we should be careful to avoid with OF. some great notes in this
>>>> essay
>>>> https://modelviewculture.com/pieces/leaving-toxic-open-source-communities
>>>> the fact that some people have left regular OF involvement and are open
>>>> about saying why makes me think OF isn't a toxic community
>>>> [4] this issue may seem minor at first, but when there is any
>>>> hesitation about contribution, then only the people who feel most entitled
>>>> and aggressive about their contributions will be the ones contributing, in
>>>> turn creating an unwelcome culture.
>>>> [5] projects are often the result of one person having an intense
>>>> interest in something, but the project lead sometimes changes over the
>>>> course of a project
>>>> [6] https://github.com/openframeworks/ofSite/pull/318
>>>> _______________________________________________
>>>> of-dev mailing list
>>>> of-dev at dev.openframeworks.cc
>>>> http://dev.openframeworks.cc/listinfo.cgi/of-dev-openframeworks.cc
>>> --
>>> --
>>> Elliot Woods
>>> elliot <elliot at kimchiandchips.com>@KimchiAndChips.com
>>> <http://www.kimchiandchips.com/>
>>> UK : +447944977628
>>> KR : +821034458086
>>> _______________________________________________
>>> of-dev mailing list
>>> of-dev at dev.openframeworks.cc
>>> http://dev.openframeworks.cc/listinfo.cgi/of-dev-openframeworks.cc
>> _______________________________________________
>> of-dev mailing list
>> of-dev at dev.openframeworks.cc
>> http://dev.openframeworks.cc/listinfo.cgi/of-dev-openframeworks.cc
> --
> --
> Elliot Woods
> elliot <elliot at kimchiandchips.com>@KimchiAndChips.com
> <http://www.kimchiandchips.com/>
> UK : +447944977628
> KR : +821034458086
> _______________________________________________
> of-dev mailing list
> of-dev at dev.openframeworks.cc
> http://dev.openframeworks.cc/listinfo.cgi/of-dev-openframeworks.cc
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://dev.openframeworks.cc/pipermail/of-dev-openframeworks.cc/attachments/20150107/e46eea2f/attachment.htm>

More information about the of-dev mailing list