Cumiki - エンジニアのための、ちょっといい感じのドキュメント作成ツール

14,892 views

Published on

ベータ版を始めるにあたって、ベータユーザー募集中です。
お気軽にご連絡ください。どうぞよろしくお願いします。
http://cumiki.com

Published in: Technology
1 Comment
36 Likes
Statistics
Notes
No Downloads
Views
Total views
14,892
On SlideShare
0
From Embeds
0
Number of Embeds
687
Actions
Shares
0
Downloads
30
Comments
1
Likes
36
Embeds 0
No embeds

No notes for slide

Cumiki - エンジニアのための、ちょっといい感じのドキュメント作成ツール

  1. 1. めの た じの エ い感 ール い っと 作成ツ ちょ ント ュメ ドキ ンジ アの ニ
  2. 2. 自己紹介 @ryooopan twitter.com/ryooopan facebook.com/ryooopan github.com/ryooopan 2010年 11月- 独学ではじめてウェブサイトとか作る この時PHPから入るというよくある間違いを(ry 2011年 12月- バイトのインターンでiOSアプリとか 2012年 Railsとかちょっとやりはじめる 9月- 今ココ ⇒ KinectとProcessingとかでタンジブルなデバイス作ったり NodeとArduino/Raspberry Piとかで楽器を作ったり
  3. 3. 本日エンジニアのみなさんにご紹介したいのは 今までのよりちょっといい感じの ドキュメント作成ツールです
  4. 4. みなさんの多くは誰かと 共同で開発されているかと思います
  5. 5. でも 他の人が書いたコードを読むのって 結構たいへん
  6. 6. だから 自分の書いたコードを 他の人に説明するのって結構大事
  7. 7. 「コード書いたから共有するね」という時に 方法1.コードにコメントを書く 方法2.ブログか何かにまとめる
  8. 8. 方法1.コードにコメントを書く ココ! ## Comment here $(“div”).click -> alert “Hello!” ## This is spam, Yeah! $.spam =-> [1..10000].forEach -> alert “I am spam”
  9. 9. 方法1.コードにコメントを書く ## Comment here $(“div”).click -> alert “Hello!” ## This is spam, Yeah! $.spam =-> くい りに [1..10000].forEach -> り返 :振 spam” 不 “I alert満 am ら ないか にくい とかが つかみ 目次 ントが のポイ コード
  10. 10. 方法2.ブログか何かにまとめる Daily Spam Blog 2013-10-15 written by Spam Bot $.spam =-> [1..10000].forEach -> alert “I am spam” このメソッドは10000回のアラートを 出すことができます。 このコードを使いこなせれば、あな たも立派なスパマーです。 メソッド呼び出しは... ココ!
  11. 11. 方法2.ブログか何かにまとめる Daily Spam Blog 2013-10-15 written by Spam Bot $.spam =-> [1..10000].forEach -> alert “I am spam” 不満:コ このメソッドは10000回のアラートを ードと紐 出すことができます。 付いてな い このコードを使いこなせれば、あな 本当は更 新されて たも立派なスパマーです。 いるのに ブログの コードは 古いまま ... メソッド呼び出しは...
  12. 12. まとめると、こうなります 振り返りやすい ブログに 解説 コードに紐付いてる コメントを つける
  13. 13. もうおわかりかもしれませんが 振り返りやすい ブログに 解説 コードに紐付いてる コメントを つける
  14. 14. Cumikiはココ 振り返りやすい Cumiki ブログに 解説 コードに紐付いてる コメントを つける
  15. 15. どゆこと? ポイント① コードの上にメモを貼れる ポイント② コードを自動で追跡 ポイント③ GitHub・BitBucketにpushするだけ
  16. 16. ポイント① コードの上にメモを貼れる
  17. 17. ポイント① コードの上にメモを貼れる 今までのだと コピペ ## Comment here $(“div”).click -> alert “Hello!” ## This is spam, Yeah! $.spam =-> [1..10000].forEach -> alert “I am spam” Daily Spam Blog $.spam =-> [1..10000].forEach -> alert “I am spam” このメソッドは10000回のアラー トを出すことができます。 メソッド呼び出しは...
  18. 18. ポイント① コードの上にメモを貼れる Cumikiだと ## Comment here $(“div”).click -> alert “Hello!” マウスでピーって ドラッグして... ## This is spam, Yeah! $.spam =-> [1..10000].forEach -> alert “I am spam” ピー
  19. 19. ポイント① コードの上にメモを貼れる ## Comment here $(“div”).click -> alert “Hello!” ## This is spam, Yeah! $.spam =-> [1..10000].forEach -> alert “I am spam” このメソッドは10000回のアラート を出すことができます。 メソッド呼び出しは... ぺたって メモを貼る
  20. 20. ポイント① コードの上にメモを貼れる $.spam =-> [1..10000].forEach -> alert “I am spam” このメソッドは10000回のアラー トを出すことができます。 メソッド呼び出しは... これだけで、 コードに紐付いた いい感じの メモができます おわり
  21. 21. ポイント② コードを自動で追跡
  22. 22. ポイント② コードを自動で追跡 今までだと Daily Spam Blog ## Comment here $(“div”).click -> alert “Hello!” ## This is spam, Yeah! $.spam =-> $(body).fadeOut() [1..10000].forEach -> alert “I am spam” こっちでは 追加したけど こっちは 更新されない $.spam =-> [1..10000].forEach -> alert “I am spam” このメソッドは10000回のアラー トを出すことができます。 このコードを使いこなせれば、 あなたも立派なスパマーです。
  23. 23. ポイント② コードを自動で追跡 Cumikiだと ## Comment here $(“div”).click -> alert “Hello!” ## Comment here $(“div”).click -> alert “Hello!” ## This is spam, Yeah! ## This is spam, Yeah! $.spam =-> [1..10000].forEach -> alert “I am spam” $.spam =-> $(body).fadeOut() [1..10000].forEach -> alert “I am spam” 更新しても 自動的に 選択部分を 追跡していきます
  24. 24. ポイント② コードを自動で追跡 forkした先で メモをつけても ぺた $.spam =-> [1..10000].forEach -> alert “I am spam” mergeすると ちゃんとこっちでも 反映されます $.spam =-> [1..10000].forEach -> alert “I am spam” なのでメモが全部 最新のコードに たまっていきます
  25. 25. ポイント③ GitHub・BitBucketにpushするだけ
  26. 26. ポイント③ GitHub・BitBucketにpushするだけ $ git commit -m “update” $ git push origin master ## This is spam, Yeah! $.spam =-> $(body).fadeOut() [1..10000].forEach -> alert “I am spam” Cumikiで 最新のコードに メモを取れます
  27. 27. ポイント③ GitHub・BitBucketにpushするだけ もちろん プライベートレポジトリは チーム内のみで共有 private
  28. 28. とりあえず つかってあそぼう! http://cumiki.com (サインインしなくても遊べるようになって )
  29. 29. ちなみに、名前の由来は 組み木 ネジとかを使わないで 木を組み合わせるだけで作る 日本の伝統技術 “ “ 組み木みたいに コードを組み立てるだけで 作りたいものができる おもちゃから伝統建築まで ことを目指しています
  30. 30. さいごに 今日持ってかえるモノ Cumiki ここは C です ( CodeのC )
  31. 31. どうもありがとうございました。

×