Go go fast as a developer

Slides with notes - https://www.dropbox.com/s/xxi0ux61ais9oti/Go%20go%20fast%20as%20a%20developer%20-%20with%20notes%20-%20MagmaRails%202012.pdf

Speed! Whether you're starting something new or trying out something new, you want speed. You want to try it fast, you want to learn it fast, and you want to learn the best practices fast. From a software library/plugin's perspective, the easier and more obvious it is for a new developer to try, learn and adopt a library the faster and wider its adoption will be. As a bonus, your library will generate more OMG tweets and blog posts. Eventually, you get on the cover of Linux Journal. Easy peasy.

How? It's not with "good documentation". Reading documentation slows us down and takes us out of the flow. As developers, our flow is our text editor and our terminal. So the solution for libraries is to bundle generators and text editor integration. Make it easier for a new developer to use your library than not to.

In this fast and funny session we'll look at Rails generators and text editor extensions and show how powerful they are and how easy they are to provide for each and every one of your libraries and plugins.

Remember, the Linux Journal needs you on its front cover. How hard could it be?http://www.flickr.com/photos/46457493@N00/230534494/in/set-72157594262577872

Transcript

1. KEYNOTE Dr Nic Williams @drnic | drnicwilliams.com VP Dev Evangelism, Engine Yard
2. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012
3. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012
4. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012
5. GO GO FAST AS A DEVELOPER Dr Nic Williams @drnic | drnicwilliams.com VP Dev Evangelism, Engine Yard
6. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012
7. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012
8. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012
9. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 STORY #1 In the beginning
10. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 mid 2006 1
11. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 mid 2006 mid 2009 1 75
12. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 the problem http://www.infoq.com/presentations/williams-open-source
13. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 How do you go fast whilst living with the consequences of your creations?
14. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 mid 2006 mid 2012 mid 2009 257
15. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 What is “go fast”?
16. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 to go fast: quickly iterating towards your goals
17. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012
18. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 experiments small batches continuous deployment
19. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 1. 2. 3...
20. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 start fast stay fast hand off continuously
21. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 generators dev tools deployment tools
22. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 “go slow”? • Add features that aren’t important • Fix bugs that aren’t important • Maintain unimportant features • Do all the work yourself
23. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 start fast stay fast hand off continuously
24. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 start fast • Create and use generators • If low cost to create, low cost to throw away • Bootstrap your universe
25. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 stay fast • Internal generators • Dev & deployment tools • Code Gardening
26. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 hand off continuously • Bootstrapping new developers • Document continuously • Homogenous codebases • Promote contributors
27. STORY #2 Start fast - Application generators
28. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 mid 2006 1 mid 2012 mid 2009 257
29. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 mid 2005 mid 2006 0 257 mid 2012
30. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 first projects • composite_primary_keys • dr_nic_magic_models
31. YOUR COMPANY NAME | LONG AND INTERESTING PRESENTATION TITLE | VERSION NO. XX | 06 /02/2012 $  rails  new  bigidea $  rails  g  model  Post $  rake  db:migrate $  ey  deploy missing concepts
32. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 $ appscrolls new bigidea -s postgresql \ twitter_bootstrap github eycloud install it store it deploy it
33. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 ruby in 2006 • Rails - nice structure, generators, textmate support • Rails plugins - nice structure, generator • RubyGems/Ruby - no structure, no tools
34. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 structure ruby code? • Jay Fields: “How would you structure a (non-Rails) Ruby project?” • http://blog.jayfields.com/ 2006/10/ruby-project-tree.html
35. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 newgem
36. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 newgem hoe Scaffold Dev & Deploy tools
37. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 your company best practices • How do applications look? • How are they deployed? • Document best practices • Generate best practises
38. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 “It’s not Rails best practice until it’s in the generators” Jeff Casimir at JRubyConf
39. STORY #3 Stay fast - component generators
40. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 Start fast Stay fast $  rails  new  bigidea $  rails  g  model  Post
41. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 Let’s make a generator!
42. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012
43. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 $ thor :thing foo exist create lib/foo.rb create spec/foo_spec.rb $ thor :thing bar exist create lib/bar.rb create spec/bar_spec.rb
44. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012
45. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012
46. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 # Thorfile require 'active_support/inflector' class Default < Thor include Thor::Actions attr_reader :name source_root File.expand_path("../templates", __FILE__) desc "thing NAME", "Create a new thing" def thing(name) @name = name directory "thing", "." end end example at https://github.com/drnic/things
47. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 $ rails g Usage: rails generate GENERATOR [args] ... Bootstrap: bootstrap:install bootstrap:layout bootstrap:themed Coffee: coffee:assets Cucumber: cucumber:install rails generators
48. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 appscrolls gem_group :test do gem 'cucumber-rails', :require => false gem 'capybara' gem 'database_cleaner' end after_bundler do rake "db:create" generate "cucumber:install" end
49. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 textmate bundles
50. STORY #4 Stay fast - code gardening
51. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 mid 2006 1 mid 2012 mid 2009 257
52. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 code Gardening
53. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012
54. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 me previous me future me
55. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 send love letters to future you code Gardening
56. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 Track your gardening • http://gitalytics.com/user • Search for @you • Gardened ___ repos $('#contribs_table tr').size()
57. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 Top gardeners speakers
58. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 Top gardeners speakers • @deadprogrammer - 46
59. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 Top gardeners speakers • @deadprogrammer - 46 • @geemus - 55
60. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 Top gardeners speakers • @deadprogrammer - 46 • @geemus - 55 • @leshill - 56
61. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 Top gardeners speakers • @deadprogrammer - 46 • @geemus - 55 • @leshill - 56 • @bmizerany - 94
62. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 Top gardeners speakers • @deadprogrammer - 46 • @geemus - 55 • @leshill - 56 • @bmizerany - 94 • @schacon - 137
63. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 Top gardeners speakers • @deadprogrammer - 46 • @geemus - 55 • @leshill - 56 • @bmizerany - 94 • @schacon - 137 • @tenderlove - 143
64. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 Top gardeners speakers • @deadprogrammer - 46 • @geemus - 55 • @leshill - 56 • @bmizerany - 94 • @schacon - 137 • @tenderlove - 143 • @drnic - 257
65. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 crowd interactive gardeners • Edwdin - @softr8 - 11 • Mario - @mariochavez - 15
66. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 how to garden • bundle  list • pick one & download its source • try to use it • fix README & docs for next person
67. STORY #5 Hand off continuously
68. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 newgem history • 2006 - create files & folders • 2007 - using rubigen - Rails’ own generator system • 2010 - abandoned - “bundle gem”
69. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 “There is no bigger destroyer of creative potential than the misguided decision to persevere”
70. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 you cannot write today’s code If you’re stuck on Yesterday’s coDE
71. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 is this your old code?
72. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 need more Docs? generators? tests? • For each file/class/module • Why does it exist? • How do you use it? • Answer in documentation/ generators/tests
73. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 remember: go faster • without interruption • reduce work on old code • “what to do next?” quickly
74. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 start fast stay fast hand off continuously
75. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012
76. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012
77. DR NIC | GO GO FAST AS A DEVELOPER | MAGMARAILS 2012 start fast stay fast hand off continuously