Repo Madness: Taming the Open-Source Repository
-
Upload
jeffrey-wear -
Category
Software
-
view
73 -
download
1
Transcript of Repo Madness: Taming the Open-Source Repository
![Page 1: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/1.jpg)
Prelude
![Page 2: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/2.jpg)
![Page 3: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/3.jpg)
- (void)testLogInSucceedsWithUsernameAndPassword { NSString *username = @"Jeff", *password = @"foo"; [_usernameField setText:username]; [_passwordField setText:password];
[_submitButton tap];
SLAssertTrueWithTimeout([_loginSpinner isInvalidOrInvisible], 3, @"Log-in was not successful.");
NSString *successMessage = [NSString stringWithFormat:@"Hello, %@!", username]; SLAssertTrue([[SLElement elementWithAccessibilityLabel:successMessage] isValid], @"Log-in did not succeed.");}
![Page 4: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/4.jpg)
![Page 5: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/5.jpg)
—Objective-C tests—No private APIs—No dependencies—Fully-tested
![Page 6: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/6.jpg)
AFNetworking lets you communicate with other machines so you can download images.
![Page 7: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/7.jpg)
Subliminal lets you manipulate your UI and make assertions so you can ???.
![Page 8: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/8.jpg)
—491 stars—45 watchers—13 contributors
![Page 9: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/9.jpg)
REPO MADNESS
![Page 10: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/10.jpg)
http://nshipster.com/stewardship/
Earlier this year, Mattt Thompson wrote an essay on open-source stewardship:on launching an open-source project with your eyes open to the responsibilitiesthat lie ahead.
![Page 11: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/11.jpg)
It's not enough to dump a pile of source code somewhere and declare it "open source".— Mattt Thompson
![Page 12: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/12.jpg)
✓ README✓ LICENSE✓ Cocoapods
![Page 13: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/13.jpg)
And then?
![Page 14: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/14.jpg)
![Page 15: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/15.jpg)
![Page 16: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/16.jpg)
![Page 17: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/17.jpg)
![Page 18: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/18.jpg)
![Page 19: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/19.jpg)
Hold on.
![Page 20: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/20.jpg)
![Page 21: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/21.jpg)
![Page 22: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/22.jpg)
![Page 23: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/23.jpg)
Braces keep existing growth on track.
![Page 24: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/24.jpg)
Braces support new growth.
![Page 25: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/25.jpg)
![Page 26: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/26.jpg)
![Page 27: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/27.jpg)
![Page 28: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/28.jpg)
Braces for projects.
![Page 29: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/29.jpg)
Braces support growth in...
—documentation—user support—development
![Page 30: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/30.jpg)
Braces for documentation.
![Page 31: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/31.jpg)
![Page 32: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/32.jpg)
![Page 33: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/33.jpg)
![Page 34: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/34.jpg)
![Page 35: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/35.jpg)
![Page 36: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/36.jpg)
READMEREAD FIRST
![Page 37: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/37.jpg)
![Page 38: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/38.jpg)
![Page 39: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/39.jpg)
![Page 40: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/40.jpg)
![Page 41: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/41.jpg)
![Page 42: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/42.jpg)
Braces for user support.
![Page 43: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/43.jpg)
![Page 44: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/44.jpg)
![Page 45: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/45.jpg)
![Page 46: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/46.jpg)
![Page 47: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/47.jpg)
![Page 48: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/48.jpg)
—If you need help, use Stack Overflow. (Tag 'subliminal'.)
—If you'd like to ask a general question, use Stack Overflow.
—If you've found a bug, open an issue.—If you have a feature request, open an issue.
![Page 49: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/49.jpg)
Stack Overflow is the best place for questions.
![Page 50: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/50.jpg)
![Page 51: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/51.jpg)
![Page 52: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/52.jpg)
![Page 53: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/53.jpg)
Get better issues with contributing guidelines.
![Page 54: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/54.jpg)
![Page 55: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/55.jpg)
![Page 56: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/56.jpg)
Braces for development.
![Page 57: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/57.jpg)
Many handslighten the load.
![Page 58: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/58.jpg)
In the contributing guidelines:
—How to set up development—How to make changes—How to document changes—How to test changes
![Page 59: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/59.jpg)
http://nshipster.com/unit-testing/
![Page 60: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/60.jpg)
Automated testing: as easy as
language: objective-cxcode_project: MyNewProject.xcodeprojxcode_scheme: MyNewProjectTests
![Page 61: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/61.jpg)
![Page 62: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/62.jpg)
Feature requests are
too late.
![Page 63: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/63.jpg)
Separate problemfrom solution.
![Page 64: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/64.jpg)
Optimize for issues closed,not PRs merged.
![Page 65: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/65.jpg)
Communicate.
![Page 66: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/66.jpg)
Say thanks.
![Page 67: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/67.jpg)
![Page 68: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/68.jpg)
Links
—http://nshipster.com/stewardship/—https://github.com/blog/1828-wikis-now-with-
more-love—http://stackoverflow.com/help/privileges/create-
tags—https://github.com/blog/1184-contributing-
guidelines—https://github.com/inkling/Subliminal/blob/
master/CONTRIBUTING.md
![Page 69: Repo Madness: Taming the Open-Source Repository](https://reader030.fdocuments.in/reader030/viewer/2022032616/55a8115b1a28ab10748b469b/html5/thumbnails/69.jpg)
Links con't.
—http://docs.travis-ci.com/user/languages/objective-c/
—https://github.com/inkling/Subliminal/wiki/Continuous-Integration
—https://gitter.im/