rabbit-slide-kou-rubykaigi-2013 2013.6.1.0

data/.rabbit

@@ -0,0 +1 @@
+be-a-library-developer.rab

data/README.rd

@@ -0,0 +1,48 @@
+= Be a library developer!
+
+Is there a gem author around you? Did you meet any author of the gems
+used? Did you contact with any author of the gems used on the
+Internet?
+
+Do you think that "the author is cool!", "the author is awesome!" or
+"I respect the author!"? Do you want to be a gem author?
+
+This talk doesn't describe about how to create a gem because it is
+easy. "gem" is a package of Ruby library (, tool and so on) for easy
+to install. This talk describes about developing a library that is gem
+content.
+
+This talk is based on my experience as a library developer. This talk
+describes about how to write codes, how to write documents, release,
+support and mental set for a better "library developer". I hope that
+this talk is a trigger for increasing the number of better "library
+developers".
+
+== License
+
+CC BY-SA 3.0
+
+Use the followings for notation of the author:
+
+  * Kouhei Sutou
+
+== For author
+
+=== Show
+
+  rake
+
+=== Publish
+
+  rake publish
+
+== For viewers
+
+=== Install
+
+  gem install rabbit-slide-kou-rubykaigi-2013
+
+=== Show
+
+  rabbit rabbit-slide-kou-rubykaigi-2013.gem
+

data/Rakefile

@@ -0,0 +1,21 @@
+# Copyright (C) 2013  Kouhei Sutou <kou@clear-code.com>
+#
+# License: CC BY-SA 3.0
+
+require "rabbit/task/slide"
+
+# Edit ./config.yaml to customize meta data
+
+spec = nil
+Rabbit::Task::Slide.new do |task|
+  spec = task.spec
+  # task.spec.files += Dir.glob("doc/**/*.*")
+  # task.spec.files -= Dir.glob("private/**/*.*")
+  spec.add_runtime_dependency("rabbit-theme-clear-code")
+end
+
+desc "Tag #{spec.version}"
+task :tag do
+  sh("git", "tag", "-a", spec.version.to_s, "-m", "Publish #{spec.version}")
+  sh("git", "push", "--tags")
+end

data/be-a-library-developer.rab

@@ -0,0 +1,562 @@
+= Be a library developer!
+
+: subtitle
+   ((*R*))emember ((*t*))han ((*I*))magine
+
+: author
+   Kouhei Sutou
+: institution
+   ClearCode Inc.
+: date
+   2013/06/01
+: allotted-time
+   25m
+: theme
+   .
+
+= Table of contents
+
+  * Share this talk's goal
+  * Describe key idea
+  * Apply the key idea
+  * Wrap up & The next step
+
+= Share the goal
+
+  * ((*Share this talk's goal*))
+  * Describe key idea
+  * Apply the key idea
+  * Wrap up & The next step
+
+= This talk's goal
+
+(('tag:as-large-as-possible'))
+You know how to develope more better softwares
+
+= More better?
+
+By example
+
+= API
+
+= API: 1
+
+  # coderay ruby
+  context.save
+  context.circle(50, 50, 10)
+  context.stroke
+  context.restore
+
+(('tag:center'))(('note:from cairo gem'))
+
+= API: 1 (better)
+
+  # coderay ruby
+  context.save do
+  context.circle(50, 50, 10)
+  context.stroke
+  end
+
+(('tag:center'))(('note:from cairo gem'))
+
+= API: 1 (better)
+
+  # coderay ruby
+  context.save do
+    context.circle(50, 50, 10)
+    context.stroke
+  end
+
+(('tag:center'))(('note:from cairo gem'))
+
+= API: 2
+
+  # coderay ruby
+  # low level
+  window.get_property("opacity")
+  # better
+  window.opacity
+
+(('tag:center'))(('note:from gtk2 gem'))
+
+= API: 3 (better?)
+
+  # coderay ruby
+  # low level
+  window.get_property("visible")
+  # better
+  # ???: hint: "visible" is bool
+
+(('tag:center'))(('note:from gtk2 gem'))
+
+= API: 3 (better)
+
+  # coderay ruby
+  # low level
+  window.get_property("visible")
+  # better
+  window.visible?
+
+(('tag:center'))(('note:from gtk2 gem'))
+
+= API: 4
+
+  # coderay ruby
+  # better for record as collection
+  record["name"]
+  # better for record as object
+  record.name
+
+(('tag:center'))(('note:from groonga gem'))
+
+= API: 5
+
+  # coderay ruby
+  require "gst"
+  # ???
+  Gst.init # <- What?
+  Gst::ElementFactory.make("playbin")
+
+(('tag:center'))(('note:from gstreamer gem'))
+
+= API: 5
+
+  # coderay ruby
+  require "gst"
+  # For advanced use
+  Gst.init("--gst-debug=*:9")
+  Gst::ElementFactory.make("playbin")
+
+(('tag:center'))(('note:from gstreamer gem'))
+
+= API: 5 (better)
+
+  # coderay ruby
+  require "gst"
+  # Make optional
+  # Gst.init
+  Gst::ElementFactory.make("playbin")
+
+(('tag:center'))(('note:from gstreamer gem'))
+
+= Implementation
+
+  # coderay ruby
+  class << Gst
+    def const_missing(name)
+      init; const_get(name); end
+    def init(*argv)
+      # ...initialize library...
+      class << self
+        remove_method(:init)
+        remove_method(:const_missing)
+      end; end; end
+
+= Docuemnt
+
+= Document: 1
+
+Install:
+
+  For Debian GNU/Linux:
+    % sudo apt-get install libgtk2.0-dev
+    % gem install gtk2
+  For OS X:
+    ...
+
+= Document: 1 (better)
+
+Install:
+
+  % gem install gtk2
+
+= Release
+
+= Release: 1
+
+Announce:
+
+  Ruby 1.8.7 was released on June 1st, 2008.  In commemoration
+  of the thrid anniversary of Ruby 1.8.7, we have a new
+  patchlevel release today.  It includes several bug fixes.
+  For the detail please read the ChangeLog.
+
+= Release: 1: not good
+
+((*read the ChangeLog*))
+
+= Release: 1: better
+
+How?\nLet's think later
+
+= Confirmation
+
+= This talk's goal
+
+(('tag:as-large-as-possible'))
+You know how to develope more better softwares
+
+= More better
+
+Showed\nby examples
+
+= Table of contents
+
+  * Share this talk's goal
+  * ((*Describe key idea*))
+  * Apply the key idea
+  * Wrap up & The next step
+
+= Key idea
+
+((*R*))emember\n((*t*))han\n((*I*))magine
+
+= Imagine
+
+  * Difficult
+    * Because you didn't know
+  * Many programmers can't imagine about other people
+
+= Remember
+
+  * Easy
+    * Because you know
+  * Many Japanese Rubyists can't remember wait time
+
+= To remember,
+
+  * Experience
+  * Ask
+  * Observe
+
+= Experience!
+
+  * ((*Experience*))
+  * Ask
+  * Observe
+
+= What should you experience?
+
+= What
+
+Library user
+
+= Library user?
+
+You experienced!
+
+= Key idea
+
+((*R*))emember\n((*t*))han\n((*I*))magine
+
+= Remember
+
+= Apply the key idea
+
+  * Share this talk's goal
+  * Describe key idea
+  * ((*Apply the key idea*))
+  * Wrap up & The next step
+
+= API
+
+= API: 1
+
+  # coderay ruby
+  context.save
+  context.circle(50, 50, 10)
+  context.stroke
+  context.restore
+
+(('tag:center'))(('note:from cairo gem'))
+
+= API: 1: Point
+
+  # coderay ruby
+  context.save    # Setup
+  context.circle(50, 50, 10)
+  context.stroke
+  context.restore # Teardown
+
+(('tag:center'))(('note:from cairo gem'))
+
+= Remember
+
+File
+
+= Remember: File
+
+  # coderay ruby
+
+  # Setup
+  file = File.open(path)
+  file.read
+  # Teardown
+  file.close
+
+= Remember: File
+
+  # coderay ruby
+  # Ensure teardown
+  File.open(path) do |file|
+    file.read
+    raise "error!"
+  end
+
+= do ... end style
+
+Merit:\n
+Ensure close
+
+= API: 1
+
+  # coderay ruby
+  context.save    # Setup
+  context.circle(50, 50, 10)
+  context.stroke
+  context.restore # Teardown
+
+(('tag:center'))(('note:from cairo gem'))
+
+= API: 1 (better)
+
+  # coderay ruby
+  # Ensure teardown
+  context.save do
+    context.circle(50, 50, 10)
+    context.stroke
+  end
+
+(('tag:center'))(('note:from cairo gem'))
+
+= API: 2
+
+  # coderay ruby
+  # low level
+  window.get_property("opacity")
+  # better
+  window.opacity
+
+(('tag:center'))(('note:from gtk2 gem'))
+
+= API: 2: Point
+
+property\n==\nattribute
+
+= Remember
+
+Normal object
+
+= API: 2
+
+  # coderay ruby
+  # low level
+  window.get_property("opacity")
+  # better
+  window.opacity
+
+(('tag:center'))(('note:from gtk2 gem'))
+
+= API: 3 (better?)
+
+  # coderay ruby
+  # low level
+  window.get_property("visible")
+  # better
+  # ???: hint: "visible" is bool
+
+(('tag:center'))(('note:from gtk2 gem'))
+
+= Remember
+
+Predicate
+
+= Remember: Predicate
+
+  # coderay ruby
+  [].empty?
+  0.zero?
+
+= API: 3 (better)
+
+  # coderay ruby
+  # low level
+  window.get_property("visible")
+  # better: "?" suffix
+  window.visible?
+
+(('tag:center'))(('note:from gtk2 gem'))
+
+= API: 4
+
+  # coderay ruby
+  # better for record as collection
+  record["name"]
+  # better for record as object
+  record.name
+
+(('tag:center'))(('note:from groonga gem'))
+
+= API: 5
+
+  # coderay ruby
+  require "gst"
+  # ???
+  Gst.init # <- What?
+  Gst::ElementFactory.make("playbin")
+
+(('tag:center'))(('note:from gstreamer gem'))
+
+= API: 5
+
+  # coderay ruby
+  require "gst"
+  # For advanced use
+  Gst.init("--gst-debug=*:9")
+  Gst::ElementFactory.make("playbin")
+
+(('tag:center'))(('note:from gstreamer gem'))
+
+= Remember
+
+Socket
+
+= Socket in C
+
+  # coderay c
+  int fd;
+  struct sockaddr *address;
+  fd = socket(PF_INET, SOCK_STREAM, 0);
+  /* address.sa_family = ...; */
+  connect(fd, address, address_size);
+
+= Socket in Ruby
+
+  # coderay ruby
+  TCPSocket.new("www.ruby-lang.org", 80)
+
+= Point
+
+Provide defaults
+
+= API: 5 (better)
+
+  # coderay ruby
+  require "gst"
+  # Make optional
+  # Gst.init
+  Gst::ElementFactory.make("playbin")
+
+(('tag:center'))(('note:from gstreamer gem'))
+
+= Docuemnt
+
+= Document: 1
+
+Install:
+
+  For Debian GNU/Linux:
+    % sudo apt-get install libgtk2.0-dev
+    % gem install gtk2
+  For OS X:
+    ...
+
+= Remember
+
+You installed Nokogiri
+
+= Remember: Nokogiri
+
+  % gem install nokogiri
+  ...
+  libxml2 is missing. ...
+  ...
+  *** extconf.rb failed ***
+
+= Remember: Nokogiri
+
+  % sudo apt-get install libxml2-dev
+
+= Remember: Nokogiri
+
+  % gem install nokogiri
+  ...
+  libxslt is missing. ...
+  ...
+  *** extconf.rb failed ***
+
+= Document: 1 (better)
+
+Install:
+
+  % gem install gtk2
+  (with auto "apt-get install")
+
+= Release
+
+= Release: 1
+
+Announce:
+
+  Ruby 1.8.7 was released on June 1st, 2008.  In commemoration
+  of the thrid anniversary of Ruby 1.8.7, we have a new
+  patchlevel release today.  It includes several bug fixes.
+  For the detail please read the ChangeLog.
+
+= Release: 1: not good
+
+((*read the ChangeLog*))
+
+= Release: 1: better
+
+How?\nLet's think later
+
+TODO
+
+= Wrap up
+
+  * Share this talk's goal
+  * Describe key idea
+  * Apply the key idea
+  * ((*Wrap up*)) & The next step
+
+= This talk's goal
+
+(('tag:as-large-as-possible'))
+You know how to develope more better softwares
+
+= Key idea
+
+((*R*))emember\n((*t*))han\n((*I*))magine
+
+= Remember than Imagine
+
+  * Imagine
+    * Difficult
+  * Remember
+    * Easy
+
+= For development
+
+  * Experience library user
+    * You must done!
+  * Then ((*remember*)) the experience
+
+= The next step
+
+  * Share this talk's goal
+  * Describe key idea
+  * Apply the key idea
+  * Wrap up & ((*The next step*))
+
+= Be a library developer
+
+= Why?
+
+  * It is good experience for "remember than imagine"
+  * "library developer" experience is useful to 
+    develope other softwares such as Ruby
+
+= Conclusion
+
+TODO

data/config.yaml

@@ -0,0 +1,22 @@
+---
+id: rubykaigi-2013
+base_name: be-a-library-developer
+tags:
+- rabbit
+- rubykaigi
+- library
+presentation_date: 2013/06/01
+version: 2013.6.1.0
+licenses:
+- CC BY-SA 3.0
+slideshare_id: 
+speaker_deck_id: 
+ustream_id: 
+vimeo_id: 
+author:
+  markup_language: :rd
+  name: Kouhei Sutou
+  email: kou@clear-code.com
+  rubygems_user: kou
+  slideshare_user: kou
+  speaker_deck_user: kou

metadata

@@ -0,0 +1,113 @@
+--- !ruby/object:Gem::Specification
+name: rabbit-slide-kou-rubykaigi-2013
+version: !ruby/object:Gem::Version
+  version: 2013.6.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Kouhei Sutou
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-05-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rabbit
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.0.2
+- !ruby/object:Gem::Dependency
+  name: rabbit-theme-clear-code
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ! 'Is there a gem author around you? Did you meet any author of the gems
+
+  used? Did you contact with any author of the gems used on the
+
+  Internet?
+
+
+  Do you think that "the author is cool!", "the author is awesome!" or
+
+  "I respect the author!"? Do you want to be a gem author?
+
+
+  This talk doesn''t describe about how to create a gem because it is
+
+  easy. "gem" is a package of Ruby library (, tool and so on) for easy
+
+  to install. This talk describes about developing a library that is gem
+
+  content.
+
+
+  This talk is based on my experience as a library developer. This talk
+
+  describes about how to write codes, how to write documents, release,
+
+  support and mental set for a better "library developer". I hope that
+
+  this talk is a trigger for increasing the number of better "library
+
+  developers".'
+email:
+- kou@clear-code.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .rabbit
+- config.yaml
+- Rakefile
+- README.rd
+- be-a-library-developer.rab
+- pdf/rubykaigi-2013-be-a-library-developer.pdf
+homepage: http://slide.rabbit-shocker.org/authors/kou/rubykaigi-2013/
+licenses:
+- CC BY-SA 3.0
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Be a library developer!
+test_files: []