'How Open Source Development can make you a better developer' by Arthur Sabintsev

Everyone uses Open Source Software, but not everyone contributes back to the community. Some are scared of being judged on their skill, while others may feel that they have nothing to share. These excuses couldn’t be farther from the truth! Open Source Development, especially in the Swift community, is fun, exciting, and especially welcoming! With 5 years of OSS experience, 7300+ stars on GitHub, over 1.5 million downloads on CocoaPods, and contributions to established projects, like Swift, and the Swift Source Compatibility Suite, Arthur will discuss how contributing has made me a more confident developer, share the lessons learned in the process, and most importantly, convince others that their contributions will better themselves and the community!
He also will talk about how to get involved in open source, and how to contribute to Swift.

This talk was made for CocoaHeads Kyiv #13 which took place Dec 16 2017.

Transcript

1. How Open Source So-ware Development Can Make You a Be9er Developer Arthur Sabintsev Lead iOS Developer The Washington Post © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 1
2. "Open source so,ware is so,ware with source code that anyone can inspect, modify, and enhance." — OpenSource.com © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 2
3. OSS Résumé • 1.3 million+ downloads via CocoaPods1 • 7,200+ stars on GitHub2 • Contributed to Swi@ 3.13 • Contributed to Swi@ Source CompaBbility4 5 Stats on the right generated by GitFame6 6 GitFame: Swi- CLI Script That Logs GitHub Stars and Forks. 5 Swi& Source Compa0bility Suite 4 Guitar: Pla,orm-Independent Regular Expression and String Library 3 XCTAssertNoThrow Implementa5on for Swi9 3.1 2 GitHub Account for ArtSabintsev 1 CocoaPods Stats for ArtSabintsev © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 3
4. You don't need a computer science degree to contribute to Open Source. — Lesson #1 © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 4
5. 4 Types of Open-Source Projects Based on Adop8on7 1. No Adop)on 2. Adop)on 3. Gold Standard 4. Hyper-Scale 7 Feilx Krause's Four Stages of Open Source Projects © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 5
6. Journey into the past, to a 0me before • JSON Parsing libs (Argo, Gloss, Swi/yJSON, etc.) • Auto Layout libs (PureLayout, SnapKit, Stevia, etc.) • Async. Image Downloading libs (Kingfisher, SDWebImage, etc.) • Journey back to the days of Pull to Refresh! © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 6
7. © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 7
8. Drive+ by Porsche & Duca* Community for Duca0 © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 8
9. Programmers are like Blacksmiths, we create our own tools. — Lesson #2 © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 9
10. Gump%on — Lesson #3 © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 10
11. The Float Label Pa-ern 8 9 10 10 UIFloatLabelTextView 9 UIFloatLabelTextField 8 The Float Label Pa.ern by Ma. D. Smith © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 11
12. Swizzling UITextField's Clear Bu8on - (void)setuptextFieldClearButton { // A boolean that toggles the state of the keyboard after the clear-text button is pressed. _dismissKeyboardWhenClearingTextField = @NO; // Create selector for Apple's built-in UITextField button - clearButton SEL clearButtonSelector = NSSelectorFromString(@"clearButton"); // Reference clearButton getter IMP clearButtonImplementation = [self methodForSelector:clearButtonSelector]; // Create function pointer that returns UIButton from implementation of method that contains clearButtonSelector UIButton * (* clearButtonFunctionPointer)(id, SEL) = (UIButton *(*)(id, SEL))clearButtonImplementation; // Set textFieldClearButton reference to "clearButton" from clearButtonSelector _textFieldClearButton = clearButtonFunctionPointer(self, clearButtonSelector); if (_textFieldClearButton) { // Remove all textFieldClearButton target-actions (e.g., Apple's standard clearButton actions) [self.textFieldClearButton removeTarget:nil action:NULL forControlEvents:UIControlEventAllEvents]; // Add new target-action for textFieldClearButton [_textFieldClearButton addTarget:self action:@selector(clearTextField) forControlEvents:UIControlEventTouchUpInside]; } } © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 12
13. Experimen)ng with APIs You Normally Wouldn't Use 11 /// Returns the latinized version of the string without diacritics. /// /// let string = "Hello! ͩΩ΁ͷ΅! สวัสดี! ﻣ ﺮ ﺣ ﺒ ﺎ ! ఍অ!" /// print(string.latinized()) /// // Prints "Hello! kon'nichiha! swasdi! mrhba! nin hao!" /// /// - Returns: The latinized version of the string without diacritics. @discardableResult func latinized() -> String { #if !os(Linux) if #available(iOS 9.0, macOS 10.11, tvOS 9.0, watchOS 3.0, *) { return (applyingTransform(.toLatin, reverse: false) ?? self).withoutAccents() } else { assertionFailure("The latinized function is only available iOS 9.0+, macOS 10.11+, tvOS 9.0+, and watchOS 3.0+") return self.withoutAccents() } #else assertionFailure("The latinized function is only available for Darwin devices; iOS, macOS, tvOS, watchOS") return self.withoutAccents() #endif } 11 Guitar © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 13
14. Learn and experiment with language and pla2orm APIs that you normally wouldn't in your day job. — Lesson #4 © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 14
15. Harpy & Siren Checks currently installed version of your app against the version that is available in the App Store. © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 15
16. Package Managers • CocoaPods • Carthage • Swi1 Package Manager © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 16
17. Con$nuous Integra$on • BuddyBuild.com / Travis CI • YAML Files • Pre-Install & Post-Install Scripts © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 17
18. Interna'onaliza'on (i18n) & Localiza'on (l10n) • Adding ability to be used across Languages • NSLocalizedString, Custom Bundles • Localized for 40 Languages. • Overriding iOS-system-level localizaBon © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 18
19. Being a Maintainer vs. Being a Consumer • I rarely use Harpy and Siren • 80,000+ combined monthly downloads • Consumers: • Report when the projects stop working • Request features • Add features via PRs © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 19
20. Maintaining an Open Source project is both a rewarding and thankless job. — Lesson #5 © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 20
21. How to Contribute to Open Source © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 21
22. Contribu)ng to Swi. • Search bugs.swi0.org for StarterBug issues that are Open. • Search the Swi0 and Corelibs repositories for • NSUnimplemented() • // FIXME: Unsupported © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 22
23. Contribu)ng to Established Projects (1/2) • Issues posted by the maintainer © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 23
24. Contribu)ng to Established Projects (2/2) • Look at labels: • starter task • help • feature • bug • Help me implement a rule in Swi6Lint! • Swi6Lint#1315 © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 24
25. Crea%ng Your Own Project • Add a README • Document every line of public code • Document private code as necessary • Add Documenta8ons using Jazzy • Add Tests and hook up to Con8nuous Integra8on • Add a document describing the Vision (e.g., VISION.md) • Add issues delinea8ng future features • Mark some with labels, like Starter Tasks © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 25
26. Marke&ng your Library • Submit to Mailing Lists • iOS Dev Weekly - Dave Verwer, Evan Dekhayser, Vicc Alexander • This Week in SwiD - Natasha The Robot • iOS Goodies - Rui Peres & Tiago Almeida • Lil' Bites of Cocoa - Jake Marsh • iOS Cookies - Adam Bardon • SwiD Weekly - 9Elements • SwiD Developments - Andy Bargh • TwiQer • #swiDlang, #iosdev © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 26
27. Maintenance Tips & Tricks © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 27
28. Issue Templates • Pre-populate the New Issue screen with informa5on that informs people about previously answered ques5ons. • Located at /path/to/ project/.github/ ISSUE_TEMPLATE.md © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 28
29. Pull Requests vs. Issues Turn off issues in favor of pull requests13 PRs require the consumer to (at the very least): • RTFM. • Provide sample code for a feature. • A9empt fixing a bug. • Understand how to fork a GitHub project and open a PR. 13 Turning Off Github Issues © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 29
30. The 5 Day Rule If a consumer opens an Issue/PR, but does not follow up to your ques9ons/comments within 5 work days, close the Issue/PR and move on. © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 30
31. Network of Trust ...built on a network of trust among developers that have come to know each other over the years. There’s no way I can test all the pla<orms we support – the same way there is no way I can check every single commit that gets merged..." — Linus Torvalds14 14 Video: Linus Torvalds on How to Build a Successful Open Source Project © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 31
32. Depreca'ng A Project • Update the README • Remove the codebase from the final commit © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 32
33. Passing the Torch • Jesse Squires recently deprecated JSQMessagesViewController15 • MessageKit is a community effort to support a rewri?e Swi@ version of the library 15 Officially Depreca/ng JSQMessagesViewController Blog Post © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 33
34. Final Words of Advice © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 34
35. From The Shark Tank © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 35
36. © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 36
37. Thank You! h"ps:/ /github.com/ArtSabintsev/360iDev-2017 © 2017, Arthur Ariel Sabintsev. ArtSabintsev on Twi:er & Github. 37