leihs, the leading free equipment booking system It took us eight years to get it right. What we learned about being a FOSS project.

Size: px

Start display at page:

Download "leihs, the leading free equipment booking system It took us eight years to get it right. What we learned about being a FOSS project."

Scott Montgomery
6 years ago
Views:

1 leihs, the leading free equipment booking system It took us eight years to get it right. What we learned about being a FOSS project. Ramón Cahenzli ramon.cahenzli@zhdk.ch

2 OpenVZ Linux Containers

3 leihs

4 Multilingual recursive acronym leihs is an easy inventory handling system leihs ist ein einfaches inventarhandhabungssystem leihs permet d'emprunter votre inventaire habilement et systématiquement leihs är ett enkelt inventarhanteringssystem leihs ei inventaarioita helpommaksi saa

5 Ausleihsystem

6 What does leihs do?

7 Main building Lending managers Film student Theater department Film department Fine arts student

8 Main building Lending managers Film student max. quantity = 1 Theater department Film department Fine arts student

9 Main building Theater department Film department Lending managers Film student max. quantity = 2 Fine arts student

10 Why?

12 Some mistakes

13 Mistake 1 To have non-english code

16 What might the show method be called?

22 Mistake 2 To be on the bleeding edge

23 2004 Rails logo David Heinemeier Hansson

24 leihs 2004 Rails logo David Heinemeier Hansson 2005

25 leihs 2004 Photo credit: (CC) By-NC Alex Proimos Rails logo David Heinemeier Hansson

26 Very scientific chart Writing new features Catching up to your platform New platform Established platform

27 RubyGems 0.x Rails Ruby

28 RubyGems 0.x Rails Ruby

29 Mistake 3 Internationalization? We'll add that later!

31 1,037 times!

32 Mistake 4 No tests

33 t Rspec No tests

34 t :( Rspec No tests

35 t :( Rspec Rspec Story Runner No tests No tests

36 t :( :( Rspec Rspec Story Runner No tests No tests

37 t Rspec and Cucumber :( :( Rspec Rspec Story Runner No tests No tests

38 t Rspec and Cucumber :( :( Rspec :( Rspec Story Runner No tests No tests

39 t Rspec and Cucumber :( :( Rspec :( Rspec Story Runner Cucumber No tests No tests

40 t Rspec and Cucumber :( :( Rspec :( Rspec Story Runner Cucumber No tests No tests :

41 9 hours test execution

44 Cider CI CI system/framework for parallelized and resilient integration testing (not created by the ZHdK but by our teammate Thomas Schank)

45 :

46 :)

47 Mistake 5 Starting without a user interface person

61 Photo credit: (CC) By-NC-SA 2.0 Héctor García.

62 Photo credit: (CC) By-NC-SA 2.0 Héctor García. Java JavaScript HTML5 CSS3 JSON

63 Photo credit: (CC) By-NC-SA 2.0 Héctor García. Java JavaScript ERB HTML5 CoffeeScript CSS3 JSON XML Asset pipeline REST Ruby ActiveRecord bash

64 Photo credit: (CC) By-NC-SA 2.0 Héctor García. JavaScript Java ERB HTML5 CoffeeScript CSS3 Asset pipeline JSON XML REST PostgreSQL ActiveRecord SQL MSSQL Ruby MySQL HAML YAML Gherkin Ansible zsh Capistrano bash

65 Photo credit: (CC) By-NC-SA 2.0 Héctor García. JavaScript Java Typography ERB HTML5 CoffeeScript CSS3 Layout Scalability Asset pipeline JSON XML REST PostgreSQL ActiveRecord SQL MSSQL Ruby MySQL HAML YAML Gherkin Ansible zsh Capistrano bash

66 Photo credit: (CC) By-NC-SA 2.0 Héctor García. Typography Usability testing Color theory Style guides JavaScript Java ERB HTML5 CoffeeScript CSS3 Layout Scalability Asset pipeline JSON XML REST PostgreSQL ActiveRecord SQL MSSQL Ruby MySQL HAML YAML Gherkin Ansible zsh Capistrano bash

67 Photo credit: (CC) By-NC-SA 2.0 Héctor García. Typography Usability testing Color theory Style guides ERB HTML5 CoffeeScript CSS3 Layout Scalability Information Graphic architecture design Usability Data visualization inspection JavaScript Java Asset pipeline JSON XML REST PostgreSQL ActiveRecord SQL MSSQL Ruby MySQL HAML YAML Gherkin Ansible zsh Capistrano bash

68 Photo credit: (CC) By-NC-SA 2.0 Héctor García. Typography Usability testing Color theory Style guides ERB HTML5 CoffeeScript CSS3 Layout Scalability Information Graphic architecture design Usability Data visualization inspection Interface Discoverability design Inkscape GIMP JavaScript Java Asset pipeline JSON XML REST PostgreSQL ActiveRecord SQL MSSQL Ruby MySQL HAML YAML Gherkin Ansible zsh Capistrano bash

69 Photo credit: (CC) By-NC-SA 2.0 Héctor García. Typography Usability testing Color theory Style guides ERB HTML5 CoffeeScript CSS3 Layout Scalability Information Graphic architecture design Usability Data visualization inspection Interface Discoverability design Inkscape GIMP JavaScript Java Asset pipeline JSON XML REST PostgreSQL ActiveRecord SQL MSSQL Ruby MySQL HAML YAML Gherkin Ansible zsh Capistrano bash

70 Photo credit: (CC) By-NC-SA 2.0 Héctor García. Typography Usability testing Color theory Style guides Scalability JavaScript Java ERB HTML5 CoffeeScript CSS3 Layout re Information Graphic architecture design Usability Data visualization inspection Interface Discoverability design Inkscape GIMP kt Asset pipeline JSON XML REST PostgreSQL ActiveRecord SQL MSSQL Ruby MySQL HAML YAML Gherkin Ansible zsh Capistrano bash

71 Mistake 6 Implementing organization-specific features

77 Enough about mistakes already! :(

78 Hints and observations

79 BDD is hard Create a glossary Use boring, idiom-free, colorless language

80 Bad (but fun) BDD scenario: When shit's all fucked up And there ain't no hustlas that still have the goods, yo Then holler out to all yo brothas, for real Better (and boring) BDD scenario: When at least one crucial configuration setting is missing And no inventory pool has any more items available Then display a warning in the global warning section

81 Bad (but fun) BDD scenario: When shit's all fucked up And there ain't no hustlas that still have the goods, yo Then holler out to all yo brothas, for real Better (and boring) BDD scenario: When at least one crucial configuration setting is missing And no inventory pool has any more items available Then display a warning in the global warning section

82 Management Make sure management understands what Free Software is. Let them give you a good product owner that understands, too. Get authorization to spend hours working with the community. You will spend more time developing than if you were doing this only for your own organization.

83 If you are gov't You are using taxpayer money to make software. Give the taxpayers the software they paid for.

84 Definitely a hint Learn to say no.

85 Definitely a hint Learn to say no. (But first, have a good idea of where the journey goes, otherwise you're just being a jerk.)

86 Mad bullet points, yo Solid vision Stable platform Internationalization from day one Interaction designers Tests Good community work Educated management Know when to say no

87 Mad bullet points, yo Solid vision Stable platform Internationalization from day one Interaction designers Tests Good community work Educated management Know when to say no = great success

88 Thank you! Zürich University of the Arts zhdk.ch leihs github.com/zhdk/leihs

89 leihs, the leading free equipment booking system It took us eight years to get it right. What we learned about being a FOSS project. Ramón Cahenzli ramon.cahenzli@zhdk.ch

90 OpenVZ Linux Containers We are what I hope is a typical university, using the usual Free and Open Source suspects.

91 leihs But we also develop our own Free Software, and one of those is leihs.

92 Multilingual recursive acronym leihs is an easy inventory handling system leihs ist ein einfaches inventarhandhabungssystem leihs permet d'emprunter votre inventaire habilement et systématiquement leihs är ett enkelt inventarhanteringssystem leihs ei inventaarioita helpommaksi saa

93 Ausleihsystem

94 What does leihs do?

95 Main building Lending managers Film student Theater department Film department Fine arts student

96 Main building Lending managers Film student max. quantity = 1 Theater department Film department Fine arts student

quantity = 2 Fine arts student There are ten

Still total flexibility for the inventory

97 Main building Theater department Film department Lending managers Film student max. quantity = 2 Fine arts student There are ten thousand things that can go wrong here, and leihs tries to minimize the impact and handle things well. Still total flexibility for the inventory managers with ability to override almost everything and cause their own problems.

98 Why? There was nothing like it, even proprietary software didn't quite fit, it was meant for rental companies. Now it handles more than 15'000 reservations a year at ZHdK alone, we couldn't work without it. Latest version even handles tracking software licenses. Manual process, but it's there.

100 Some mistakes

101 Mistake 1 To have non-english code

102

103

104 What might the show method be called?

105

106

107

108

109

110 Mistake 2 To be on the bleeding edge

111 2004 Rails logo David Heinemeier Hansson

112 leihs 2004 Rails logo David Heinemeier Hansson 2005

113 leihs 2004 Photo credit: (CC) By-NC Alex Proimos Rails logo David Heinemeier Hansson

114 Very scientific chart Writing new features Catching up to your platform New platform Established platform

115 RubyGems 0.x Rails Ruby

116 RubyGems 0.x Rails Ruby incompatibilities between contemporary versions of things, some of which we would be supposed to support at the same time, but which isn't possible. downgrade instructions necessary.

117 Mistake 3 Internationalization? We'll add that later!

118

119 1,037 times!

120 Mistake 4 No tests

121 t Rspec No tests When we got frustrated about not having tests and constantly running into regressions, we thought we'd try rspec.

122 t :( Rspec No tests

123 t :( Rspec Rspec Story Runner No tests No tests But we couldn't make it work any better than Test::Unit did, and besides, we couldn't muster the discipline. When the Rspec Story Runner came along, we got curious because that seemed like an interesting new way to write tests.

124 t :( :( Rspec Rspec Story Runner No tests No tests Unfortunately, that was quite buggy at the time.

125 t Rspec and Cucumber :( :( Rspec Rspec Story Runner No tests No tests The Story Runner evolved into Cucumber, which had a lot fewer bugs, so we started using that along with whatever we already had, which was in Rspec.

126 t Rspec and Cucumber :( :( Rspec :( Rspec Story Runner No tests No tests We got confused and unhappy because the distinction of which test would go where was rarely easy and we didn't have time to maintain two test suites.

127 t Rspec and Cucumber :( :( Rspec :( Rspec Story Runner Cucumber No tests No tests So we dropped Rspec and went with only Cucumber. Also at this point, our product owner joined in with writing Cucumber scenarios. That makes it a lot more fun to write scenarios, and it makes the result of our programming more accurately reflect what the PO wanted.

128 t Rspec and Cucumber :( :( Rspec :( Rspec Story Runner Cucumber No tests No tests : Looking good, there!

129 9 hours test execution

130

131

132 Cider CI CI system/framework for parallelized and resilient integration testing (not created by the ZHdK but by our teammate Thomas Schank)

133 :

134 :)

135 Mistake 5 Starting without a user interface person

136

137

138

139

140

141

142

143

144

145

146

147

148

149 Photo credit: (CC) By-NC-SA 2.0 Héctor García.

150 Photo credit: (CC) By-NC-SA 2.0 Héctor García. Java JavaScript HTML5 CSS3 JSON

151 Photo credit: (CC) By-NC-SA 2.0 Héctor García. Java HTML5 ERB CoffeeScript CSS3 JSON XML JavaScript Asset pipeline REST Ruby ActiveRecord bash

152 Photo credit: (CC) By-NC-SA 2.0 Héctor García. JavaScript Java HTML5 ERB CoffeeScript CSS3 Asset pipeline JSON XML REST PostgreSQL ActiveRecord SQL MSSQL Ruby MySQL HAML YAML Gherkin Ansible zsh Capistrano bash

153 Photo credit: (CC) By-NC-SA 2.0 Héctor García. JavaScript Java Typography HTML5 Layout Scalability ERB CoffeeScript CSS3 Asset pipeline JSON XML REST PostgreSQL ActiveRecord SQL MSSQL Ruby MySQL HAML YAML Gherkin Ansible zsh Capistrano bash

154 Photo credit: (CC) By-NC-SA 2.0 Héctor García. Typography Usability testing Color theory Style guides JavaScript Java HTML5 Layout Scalability ERB CoffeeScript CSS3 Asset pipeline JSON XML REST PostgreSQL ActiveRecord SQL MSSQL Ruby MySQL HAML YAML Gherkin Ansible zsh Capistrano bash

155 Photo credit: (CC) By-NC-SA 2.0 Héctor García. Typography Usability testing Color theory Style guides HTML5 Layout Scalability Information Graphic architecture design Usability Data visualization inspection JavaScript Java ERB CoffeeScript CSS3 Asset pipeline JSON XML REST PostgreSQL ActiveRecord SQL MSSQL Ruby MySQL HAML YAML Gherkin Ansible zsh Capistrano bash

156 Photo credit: (CC) By-NC-SA 2.0 Héctor García. Typography Usability testing Color theory Style guides HTML5 Layout Scalability Information Graphic architecture design Usability Data visualization inspection Interface Discoverability design GIMP Inkscape JavaScript Java ERB CoffeeScript CSS3 Asset pipeline JSON XML REST PostgreSQL ActiveRecord SQL MSSQL Ruby MySQL HAML YAML Gherkin Ansible zsh Capistrano bash

157 Photo credit: (CC) By-NC-SA 2.0 Héctor García. Typography Usability testing Color theory Style guides HTML5 Layout Scalability Information Graphic architecture design Usability Data visualization inspection Interface Discoverability design GIMP Inkscape JavaScript Java ERB CoffeeScript CSS3 Asset pipeline JSON XML REST PostgreSQL ActiveRecord SQL MSSQL Ruby MySQL HAML YAML Gherkin Ansible zsh Capistrano bash

Photo credit: (CC) By-NC-SA 2.0 Héctor García. https://www.flickr.

158 Photo credit: (CC) By-NC-SA 2.0 Héctor García. Typography Usability testing Color theory Style guides Scalability HTML5 Layout re Information Graphic architecture design Usability Data visualization inspection Interface Discoverability design GIMP Inkscape JavaScript Java kt ERB CoffeeScript CSS3 Asset pipeline JSON XML REST PostgreSQL ActiveRecord SQL MSSQL Ruby MySQL HAML YAML Gherkin Ansible bash zsh Capistrano if you try to stuff all of this into one person, that person will be rekt.

159 Mistake 6 Implementing organization-specific features

160

161

162

163

164

165 Enough about mistakes already! :(

166 Hints and observations

167 BDD is hard Create a glossary Use boring, idiom-free, colorless language

168 Bad (but fun) BDD scenario: When shit's all fucked up And there ain't no hustlas that still have the goods, yo Then holler out to all yo brothas, for real Better (and boring) BDD scenario: When at least one crucial configuration setting is missing And no inventory pool has any more items available Then display a warning in the global warning section

169 Bad (but fun) BDD scenario: When shit's all fucked up And there ain't no hustlas that still have the goods, yo Then holler out to all yo brothas, for real Better (and boring) BDD scenario: When at least one crucial configuration setting is missing And no inventory pool has any more items available Then display a warning in the global warning section

170 Management Make sure management understands what Free Software is. Let them give you a good product owner that understands, too. Get authorization to spend hours working with the community. You will spend more time developing than if you were doing this only for your own organization.

171 If you are gov't You are using taxpayer money to make software. Give the taxpayers the software they paid for.

172 Definitely a hint Learn to say no.

173 Definitely a hint Learn to say no. (But first, have a good idea of where the journey goes, otherwise you're just being a jerk.)

174 Mad bullet points, yo Solid vision Stable platform Internationalization from day one Interaction designers Tests Good community work Educated management Know when to say no

175 Mad bullet points, yo Solid vision Stable platform Internationalization from day one Interaction designers Tests Good community work Educated management Know when to say no = great success

176 Thank you! Zürich University of the Arts zhdk.ch leihs github.com/zhdk/leihs

Read & Download (PDF Kindle) DOS: Programming Success In A Day: Beginners Guide To Fast, Easy And Efficient Learning Of DOS Programming (DOS, ADA,

Read & Download (PDF Kindle) DOS: Programming Success In A Day: Beginners Guide To Fast, Easy And Efficient Learning Of DOS Programming (DOS, ADA, Programming, DOS Programming, ADA... LINUX, RPG, ADA Programming,