The document provides information about an open (P2P) design workshop held in Helsinki, Finland from September 17th to 24th 2011. It discusses tools for open and collaborative design including version control systems like Subversion and Git. It also discusses bug tracking tools like Trac. The workshop aimed to design collaboratively using open processes and covered topics such as version control vocabulary, versioning models, comparing file changes, and using tools like TortoiseSVN and Trac.

1. Open (P2P) Design. Workshop
How to design collaboratively an open process?
Massimo Menichinelli
---------------------------------------------------------------------------
September 17th / 24th 2011
Pixelversity – Pixelache, Helsinki
http://www.pixelache.ac/helsinki/pixelversity/programme-2011/open-p2p-
design/
Presentation available at:
http://www.slideshare.net/openp2pdesign

2. 01.
Tools:
Version Control System
(Subversion)

3. Internet and the Web enabled mass-collaboration
A version (or revision) control system is a system that tracks
incremental versions (or revisions) of fles and directories over time. It
allows you to explore the changes which resulted in each of those
versions and facilitates the arbitrary recall of the same. As the fles in
the repository are changed, the repository remembers each version of
those fles.
* Backup and Restore
* Synchronization
* Short-term undo + Long-term undo
* Track Changes
* Track Ownership
* Sandboxing
* Branching and merging
Source: http://svnbook.red-bean.com/en/1.6/svn.basic.version-control-basics.html

4. Server/client-based Version Control System
Server
Client
Client
Client Client
Source: http://www.kalekold.net/index.php?post=13

5. Distributed Version Control System
Source: http://www.kalekold.net/index.php?post=13

6. Distributed Version Control System: Git
Source: http://git-scm.com/ http://en.wikipedia.org/wiki/Git_%28software%29

7. Subversion: an open source Version Control System
Subversion manages fles and directories, and the changes
made to them, over time. This allows you to recover older
versions of your data or examine the history of how your
data changed. In this regard, many people think of a version
control system as a sort of “time machine”.
Source:
http://en.wikipedia.org/wiki/Apache_Subversion
http://subversion.apache.org/
http://subversion.tigris.org/
http://svnbook.red-bean.com/en/1.6/svn.intro.whatis.html

8. Version Control System: the vocabulary (01)
* Change
A change (or dif) represents a specifc modifcation to a document under
version control.
* Checkout
A check-out (or co) is the act of creating a local working copy from the
repository. A user may specify a specifc revision or obtain the latest. Also
refers to the same fles.
* Commit
A commit (checkin, ci) is the action of writing or merging the changes made
in the working copy back to the repository. Also refers to the same fles.
* Head
The most recent commit.
Source: http://en.wikipedia.org/wiki/Revision_control

9. Version Control System: the vocabulary (02)
* Conflict
A confict occurs when diferent parties make changes to the same document.
A user must resolve the confict by combining the changes, or by selecting
one change.
* Merge
A merge or integration is an operation in which two sets of changes are
applied to a fle or set of fles.
* Update
An update (or sync) merges changes made in the repository (by other people,
for example) into the local working copy.
* Working copy
The working copy is the local copy of fles from a repository, at a specifc time
or revision. Conceptually, it is a sandbox.
Source: http://en.wikipedia.org/wiki/Revision_control

10. Versioning model: the problem
How will the system allow users to share information, but
prevent them from accidentally overwriting?
Source:
http://svnbook.red-bean.com/en/1.6/svn.basic.version-control-basics.html

11. Versioning model: the lock-modify-unlock solution
In this model, the repository allows only one person to
change a fle at a time, by locking it.
Source:
http://svnbook.red-bean.com/en/1.6/svn.basic.version-control-basics.html

12. Versioning model: the copy-modify-merge solution (01)
In this model, each user's client contacts the project
repository and creates a personal working copy. The private
copies are merged together into a new version.
Source:
http://svnbook.red-bean.com/en/1.6/svn.basic.version-control-basics.html

13. Versioning model: the copy-modify-merge solution (01)
In this model, each user's client contacts the project
repository and creates a personal working copy. The private
copies are merged together into a new version.
Source:
http://svnbook.red-bean.com/en/1.6/svn.basic.version-control-basics.html

14. Dif: how to understand the changes
Source:
http://en.wikipedia.org/wiki/Dif
http://en.wikipedia.org/wiki/Kompare

15. The structure of a typical Subversion project
Source: http://en.wikipedia.org/wiki/Apache_Subversion

16. Let's use a real example: a spool for the RepRap Mendel
Source: http://reprap.org/wiki/Mendel

17. A spool for the RepRap Mendel: an improvement
Source: http://www.thingiverse.com/thing:3866

18. A real example, from Thingiverse
Source: http://www.thingiverse.com/about

19. A spool for the RepRap Mendel: an improvement (01)
“Well i wanted to have a
very simple, but bearing
based spool system.”
Camiel
Source: http://www.thingiverse.com/thing:3866

20. A spool for the RepRap Mendel: an improvement (02)
“I have changed the design
to put the bearings in the
spool itself. This way you
can be more fexible in
what you use to support
Source: http://www.thingiverse.com/thing:3962 the axle. ” Brokentoaster

21. A spool for the RepRap Mendel: an improvement (03)
“I liked BrokenToaster's idea of a
bearing-driven flament spool holder,
but that version was too big to ft on
a Makerbot print bed. [...] It now fts
Source: http://www.thingiverse.com/thing:4337 on a Makerbot print bed!!!” Randyy

22. A spool for the RepRap Mendel: an improvement (04)
“This takes advantage of the larger
print area on RepRaps by printing the
arm as one piece, avoiding the need for
a dovetail joint in the middle of the
Source: http://www.thingiverse.com/thing:11250 arm, thus also saving material.” Fil

23. 02.
Tools:
Version Control System
Subversion clients and tools

24. SVN Client + File comparison: TortoiseSVN (Windows)
Source: http://tortoisesvn.net/

25. SVN Client + File comparison: Eclipse (Win, Mac, Linux)
Source: http://www.eclipse.org/

26. SVN Client: SmartSVN (Win, Mac, Linux)
Source: http://www.syntevo.com/smartsvn/index.html

27. SVN Client: RapidSVN (Windows, Mac, Linux)
Source: http://www.rapidsvn.org/

28. SVN Client: Versions (Mac)
Source: http://www.versionsapp.com/

29. File comparison: Kaleidoscope (Mac)
Source: http://www.kaleidoscopeapp.com/

30. File comparison: Perforce P4Merge (Win, Mac, Linux)
Source: http://www.perforce.com/product/components/perforce_visual_merge_and_dif_tools
http://www.andymcintosh.com/?p=33
http://blog.richardadleta.com/2009/02/free-dif-merge-tool-p4merge.html

31. File comparison: Araxis Merge (Windows)
Source: http://www.araxis.com/merge/

32. File comparison: BeyondCompare (Windows, Linux)
Source: http://www.scootersoftware.com/moreinfo.php?zz=screenshot&shot=PixCompare

33. File comparison: ComparePSD (Windows)
Source: http://pixelnovel.com/comparepsd/

34. Subversion hosting service: Beanstalk
Source: http://beanstalkapp.com/

35. Subversion hosting service: Codesion
Source: http://codesion.com/

36. Subversion hosting service: Pixelnovel
Source: http://pixelnovel.com/svn-account/

37. Subversion hosting service: Google Code
Source: http://code.google.com/projecthosting/

38. 03.
Tools:
Bug Tracking
(Trac)

39. Bug Tracking? A collaborative activity with Open Source
Source: http://en.wikipedia.org/wiki/Software_bug

40. Bug Tracking: Trac – Timeline of activity
Source: http://trac.edgewall.org/

41. Bug Tracking: Trac – Milestones of the project
Source: http://trac.edgewall.org/

42. Bug Tracking: Trac – Browse the repository
Source: http://trac.edgewall.org/

43. Bug Tracking: Trac - Existing tickets
Source: http://trac.edgewall.org/

44. Bug Tracking: Trac – Create a new ticket
Source: http://trac.edgewall.org/

45. 04.
Few more (open source) books...

46. Version control with Subversion – B. Collins-Sussman,
B. Fitzpatrick & C. Pilato
Source: http://svnbook.red-bean.com/

47. Innovation Happens Elsewhere – Goldman / Gabriel
Source: http://www.dreamsongs.com/IHE/IHE.html

48. Free Software Project Management HOWTO – B. Hill
Source: http://www.tldp.org/HOWTO/Software-Proj-Mgmt-HOWTO/index.html

49. Producing Open Source Software – Karl Fogel
Source: http://producingoss.com/

50. 05.
Let's design!

51. So... here's our server:
Version Control System (Subversion):
http://workshop.openp2pdesign.org/03helsinki11/
Bug Tracking (Trac):
http://workshop.openp2pdesign.org/03helsinki11-trac/

52. A toolkit for the Open P2P Design methodology
Download it here:
http://www.issuu.com/openp2pdesign
http://www.scribd.com/openp2pdesign
http://www.openp2pdesign.org/source

53. What about the source code for Open P2P Design?
Participation matrix + } Process Design
Activity analysis +
Social Network Analysis + } Community analysis
}
Storyboard +
System map +
Service blueprint + Activity Design
Motivation matrix +
Activity description +
…
Design project + } Open Design

54. Open P2P Design Process (Participation Matrix)

55. 01. The context of the project
01.01 Choose a community, and choose one of its activities that may have
problems we want to solve with our Open Design project, that is a
collaborative design activity:
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................
or
01.01 Choose a community, and choose an existing activity, in order to see
how it can be improved through opening it to an open community around a
collaborative activity
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................

56. 02. Define the project
02.01 Which is the local context in which our project is being developed and
then realized?
..............................................................................................................................
..............................................................................................................................
..............................................................................................................................
..............................................................................................................................
..............................................................................................................................
..............................................................................................................................
02.02 Which is the community we design with and for this project?
..............................................................................................................................
..............................................................................................................................
..............................................................................................................................
..............................................................................................................................
..............................................................................................................................
..............................................................................................................................

57. 02. Define the project
02.03 Which is the problem / opportunity we may fnd within this community
we want to design with/for?
..............................................................................................................................
..............................................................................................................................
..............................................................................................................................
..............................................................................................................................
..............................................................................................................................
..............................................................................................................................
02.04 Which is the reason, our motivations, our mission, that move us to
design this project with open and p2p dynamics?
..............................................................................................................................
..............................................................................................................................
..............................................................................................................................
..............................................................................................................................
..............................................................................................................................
..............................................................................................................................

58. 02. Define the project
02.05 How do we see the future of this community? Which is the vision we
have that our collaborative process will achieve in the community and for us?
..............................................................................................................................
..............................................................................................................................
..............................................................................................................................
..............................................................................................................................
..............................................................................................................................
..............................................................................................................................
02.06 What do we want to change and communicate with this collaborative
process? Which are our values and the values of the project?
..............................................................................................................................
..............................................................................................................................
..............................................................................................................................
..............................................................................................................................
..............................................................................................................................
..............................................................................................................................

59. 03. Process: Activities and participation

60. 04. Activity Analysis
01. Which is the activity we are analysing here?
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................
02. Who is the subject of this activity? Who does carry out this activity?
..................................................................................................................................... ....
.........................................................................................................................................
.........................................................................................................................................
03. Through the activity, the subject is working actively on an object. What is
this object?
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................

61. 04. Activity Analysis
04. Which are the rules that this subject has to follow within the activity?
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................
05. How is the activity organized among the people? How is the work
divided? Which are the roles?
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................
06. Which are the artifacts (materials, tools, communications, knowledge)
that are needed in order to run the activity?
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................

62. 04. Activity Analysis
07. Which is the bigger context (the bigger community where this
collaborative community takes place) where this activity runs?
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................
07.01 Which are the reputation levels that are present in this activity? How
do people structure reputation?
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................
07.02 Which kind of participation is available to the participants? Top-
down / emergent bottom-up / a marketplace service that let people establish
p2p connections?
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................

63. 04. Activity Analysis
08. What does the activity gets in the end? Which are the results, objectives,
outcomes the activity looks for?
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................
09. Are there any contradictions (that is, sources of possible changes) within
one of the previous elements? [Primary contradictions]
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................
10. Are there any contradictions (that is, sources of possible changes)
between two (or more) of the previous elements? [Secondary contradictions]
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................

64. 04. Activity Analysis
11. Are there any contradictions (sources of possible changes) between the
existing results, objectives, outcomes and probably new ones, coming from
outside? [Tertiary contradictions]
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................
12. Are there any contradictions (sources of possible changes) between this
activity and its neighbor activities? [Quaternary contradictions]
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................
13. Which are the possible changes that these contradictions can bring?
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................

65. 05. Activity Design: Open Design Activity
01. Which is the activity we are analysing here?
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................
02. Who is the subject of this activity? Who does carry out this activity?
..................................................................................................................................... ....
.........................................................................................................................................
.........................................................................................................................................
03. Through the activity, the subject is working actively on an object. What is
this object?
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................

66. 05. Activity Design: Open Design Activity
04. Which are the rules that this subject has to follow within the activity?
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................
05. How is the activity organized among the people? How is the work
divided? Which are the roles?
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................
06. Which are the artifacts (materials, tools, communications, knowledge)
that are needed in order to run the activity?
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................

67. 05. Activity Design: Open Design Activity
07. Which is the bigger context (the bigger community where this
collaborative community takes place) where this activity runs?
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................
07.01 Which are the reputation levels that are present in this activity? How
do people structure reputation?
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................
07.02 Which kind of participation is available to the participants? Top-
down / emergent bottom-up / a marketplace service that let people establish
p2p connections?
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................

68. 05. Activity Design: Open Design Activity
08. What does the activity gets in the end? Which are the results, objectives,
outcomes the activity looks for?
.........................................................................................................................................
.........................................................................................................................................
.........................................................................................................................................
--> We (obviously) don't design contradictions but we should
look for them continuously, in order to understand when and
where the collaborative Open Design activity could be
changed and improved.

69. 06. System Map
The System Map is very useful to visualize and design interactions as fows
between people. Its elements are:
* material fows
* information fows
* fnancial fows
+ roles
+ border of the system
Source: http://www.mepss.nl/index.php?p=tool&l4=W21

70. 06. System Map

71. 07. Motivation Matrix
The Motivation Matrix is useful for analysing, designing, visualizing
interactions as motivations between the roles of the Open Design activity.
Source: http://www.servicedesigntools.org/tools/20 http://servicedesign.wikispaces.com/Motivation+Matrix

72. 08. Blueprint
Service Blueprints are used in torder to design and visualize processes and
specifcations of the Activity when it happens inside an organization
(Enterprise, Public Administration, Party ...) or there is a place where it meets
people from outside.
Source: http://www.face.ubiobio.cl/webfle/media/42/version%20-8-1/mariaperez.pdf
http://www.servicedesigntools.org/tools/35

73. 08. Blueprint
Source: http://www.fickr.com/photos/brandonschauer/3363169836/

74. 09. Storyboard
Storyboards are graphic organizers such as a series of illustrations or images
displayed in sequence for the purpose of pre-visualizing a motion picture,
animation. They enable analysing, designing, visualizing interactions
through time as a story.
Source: http://www.servicedesigntools.org/tools/13
http://en.wikipedia.org/wiki/Storyboard http://www.fickr.com/photos/ninga/473316247/

75. 10. Let's design the Reputation Levels
Explicit and tacit knowledge is what shapes the Collaborative Activity and
the Community: an open and p2p horizontal structure, as the result of the
interactions, reputation and their history:
information --> knowledge --> action --> reputation --> organization
Source: http://en.wikipedia.org/wiki/Legitimate_peripheral_participation
The structure / weight
of interactions

76. 11. License
In order to be able to design or to modify the project in a collaborative way,
we need a legal License that let us:
* share and distribute the project
* modify the project
* create a new project from another one
The License is
* a legal tool and a social contract that manage the results and the goals
Source:
http://en.wikipedia.org/wiki/Creative_commons
http://en.wikipedia.org/wiki/Public_domain
http://creativecommons.org/

77. 11. License: 01 – Review conditions
Attribution: Licensees may copy, distribute, display and perform
the work and make derivative works based on it only if they give
the author or licensor the credits in the manner specifed by these.
Non commercial: Licensees may copy, distribute, display, and
perform the work and make derivative works based on it only for
noncommercial purposes.
No Derivate Works: Licensees may copy, distribute, display and
perform only verbatim copies of the work, not derivative works
based on it.
Share alike: Licensees may distribute derivative works only under a
license identical to the license that governs the original work.
Source:
http://creativecommons.org/

78. 11. License: 02 – Select license
Source:
http://creativecommons.org/

79. 12. Business model: Business Model Generation
Source: http://www.businessmodelgeneration.com/

80. 12. Business model: a well designed canvas
Source: http://www.businessmodelgeneration.com/

81. 12. Business model: Open Source (Red Hat)
Source: http://www.businessmodelgeneration.com/
http://issuu.com/business.model.innovation/docs/business_model_generation_book_preview_embed

82. Any question or comment?

83. Thank you!
Massimo Menichinelli
-------------------------------------------------------------------
info@openp2pdesign.org
openp2pdesign.org
twitter.com/openp2pdesign