projects, community and github: 4/10/2011
Post on 17-Oct-2014
1.950 views
DESCRIPTION
Projects, Community and Github: CodeConf April 10, 2011TRANSCRIPT
![Page 1: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/1.jpg)
Projects, Community and Github
Andy Lester@petdance
![Page 2: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/2.jpg)
Who is Github for?
![Page 3: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/3.jpg)
Developers,developers,
developers,developers,
![Page 4: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/4.jpg)
Github is notfor end users.
![Page 5: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/5.jpg)
Whoo! Exposure!
Nat has 171,000 readers at radar.oreilly.com
![Page 6: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/6.jpg)
Somebody clicks the link and wants to download it, and what they're presented with is a dev-oriented home page.
![Page 7: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/7.jpg)
The download link isn't very descriptive.
![Page 8: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/8.jpg)
Github is for those who like to
build from source.
![Page 9: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/9.jpg)
![Page 10: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/10.jpg)
![Page 11: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/11.jpg)
Your usersprobably don't.
![Page 12: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/12.jpg)
![Page 13: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/13.jpg)
To the newcomer,the source treeis unimportant.
![Page 14: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/14.jpg)
What's it do?
What's it look like?
Do I want to use it?
![Page 15: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/15.jpg)
Make a project site.
• Answer the newcomer's questions.
• Aimed toward the end users.
• Users who are not as ninja as you.
• Make download + install incredibly obvious.
![Page 16: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/16.jpg)
Make a project site.
![Page 17: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/17.jpg)
Make a project site.
![Page 18: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/18.jpg)
Get your own domain.
• Not tied to github, in case things change.
• $10/year = dirt-cheap investment
• Which is easier to remember?
• http://github.com/petdance/ack
• http://betterthangrep.com/
![Page 19: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/19.jpg)
Visible, documentedreleases matter!
![Page 20: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/20.jpg)
Releases matter!
![Page 21: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/21.jpg)
Release for simplicity
• Releases are an affirmation: "Yes, you can use this."
• Single, verifiable tarball.
• Nobody wants to run autoconf.
• Users expect them.
![Page 22: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/22.jpg)
Release for historyand visibility
• Lets others build on your work.
• Make a milestone with history.
• Maintain an accurate, human-written changelog of all releases.
• A dump of commit messages is not a changelog!
![Page 23: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/23.jpg)
Optimize for your users' sake,
not your own.
![Page 24: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/24.jpg)
The needs of the many outweigh the needs of the few, or the one.
![Page 25: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/25.jpg)
About me
![Page 26: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/26.jpg)
About @petdance
• Perl guy: ack, prove, WWW::Mechanize
• Programming for money since the 1980s
• I sling PHP (eww!) for B2B web apps for a midsize corporation.
• From the midwest, Chicago area
• Diversity = good(c.f. @ginatrapani yesterday)
![Page 27: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/27.jpg)
"Dad, if you don't get it, it's because I didn't do it."
![Page 28: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/28.jpg)
Github projects have a low barrier to entry.
![Page 29: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/29.jpg)
The good part:Anyone can do it.
![Page 30: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/30.jpg)
The bad part:Anyone can do it.
![Page 31: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/31.jpg)
Newbies expect their changes to be accepted.
![Page 32: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/32.jpg)
"Can't you just...?"
![Page 33: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/33.jpg)
Be gentle in your rejections.
Brevity may be perceived as harsh.
![Page 34: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/34.jpg)
That box is too small.
![Page 35: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/35.jpg)
You want to accept changes from newbies if
at all possible.
![Page 36: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/36.jpg)
Don't reject patches just because of...
• No tests
• No documentation
• Not following code standards
• Those can all be fixed!
![Page 37: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/37.jpg)
In this morning's mail...
![Page 38: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/38.jpg)
![Page 39: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/39.jpg)
I am happy to suggest use cases that I have found useful. What is the best way - to mailing list, on a wiki somewhere, email to you.
Don't quite feel up to being more proactive. I am dyslexic and find writing stuff hard (and finishing of writing etc).
![Page 40: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/40.jpg)
Make a project guide
• Small chunks of the elephant
• "TODO: Better error handling" is not helpful to the newbie.
• Project direction
• Coding standards
• Workflow + branch strategy
![Page 41: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/41.jpg)
Monitor your network
![Page 42: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/42.jpg)
![Page 43: Projects, Community and Github: 4/10/2011](https://reader034.vdocument.in/reader034/viewer/2022051608/5441d405afaf9f4e208b47cb/html5/thumbnails/43.jpg)
Thank you• Put yourself in the newbie's shoes.
• Make a project home page outside Github.
• Visible, documented releases matter.
• Optimize for others, not yourself.
• Use Github to encourage your community, not fend it off.
• Thank you for listening and for Githubbing.