More Related Content
Similar to De-mystifying contributing to PostgreSQL
Similar to De-mystifying contributing to PostgreSQL (20)
Recently uploaded
Recently uploaded (20)
De-mystifying contributing to PostgreSQL
- 1. LOXODATA @l_avrot DE-MYSTIFYING CONTRIBUTING TO POSTGRESQL PGCON OTTAWA 2018-05-31 Lætitia AVROT Loxodata
- 2. LOXODATA @l_avrot WHO Lætitia Avrot PostgreSQL consultant and teacher DBA PostgreSQL for more than 10 years (and also Oracle and SQL Server) @l_avrot
- 3. LOXODATA @l_avrot LOXODATA Company built on 3 essential pillars PostgreSQL DevOps Cloud
- 4. LOXODATA @l_avrot WHAT Contributing to PostgreSQL The PostgreSQL community The PostgreSQL projects and tools The story of my patch How you can help
- 7. LOXODATA @l_avrot The core team 5 members Independant Act as project managers
- 8. LOXODATA @l_avrot Committers More or less 15 members Have git push permissions Responsible for code quality
- 9. LOXODATA @l_avrot Developpers C code Need to comply with Need to comment (a lot) style guide
- 10. LOXODATA @l_avrot Reviewers No need to be a dev But technical background needed If you don't understand it, others won't
- 11. LOXODATA @l_avrot Translators No need to be a dev Software messages Documentation Others (press releases...)
- 12. LOXODATA @l_avrot Advocacy Promote PostgreSQL use Share informations about PostgreSQL Regional press contacts
- 13. LOXODATA @l_avrot Associations Small to large groups of users National or international
- 14. LOXODATA @l_avrot Local user groups Local (Cities or Countries) Mostly Meetups
- 15. LOXODATA @l_avrot Local User Groups and Meetups User gathering Sharing thoughts, use cases, issues...
- 25. LOXODATA @l_avrot The road map 1 major release per year 1 minor release per quarter (minimum)
- 26. LOXODATA @l_avrot Commitfests 1 month long When most patches are commited Needs a commitFest Manager
- 31. LOXODATA @l_avrot Mailing-lists Bug submission (use the ) pgsql-novice for newcommers Special lists for associations and local groups pgsql-hackers (be carefull, these guys are SO chatty) form
- 32. LOXODATA @l_avrot Habits about mailing-lists Use Reply to all Be respectfull (but who needs that reminder ?) inline replying
- 34. LOXODATA @l_avrot IRC Live chat with other PostgreSQL users Don't ask to ask, just ask! Chanel #postgresql on irc.freenode.net
- 36. LOXODATA @l_avrot Twitter Stay in touch with other PostgreSQL users Brand new community account : @postgresql
- 37. LOXODATA @l_avrot Other ways to stay in touch Postgres Postgres Forums (as ) Slack hangout stackexchange
- 38. LOXODATA @l_avrot Git if you don't know git, don't be afraid git clone git pull (--rebase) git diff Use the PostgreSQL Wiki page
- 40. LOXODATA @l_avrot What's a patch? Source : Wikipedia A patch is a piece of software designed to update a computer program or its supporting data, to x or improve it.
- 41. LOXODATA @l_avrot My story Missing section in ALTER TABLE documentation Discussion with peers Bug reporting Patch creation with guru mentors Patch submission
- 42. LOXODATA @l_avrot Missing section in ALTER TABLE synopsys
- 43. LOXODATA @l_avrot Creating the patch PostgreSQL git clone Copy/Paste missing section from CREATE TABLE to ALTER TABLE Re-building documentation from source code Building from source code Building documentation from source code
- 44. LOXODATA @l_avrot Finding where to make your modi cations Use grep Ask around! Think (a little)
- 45. LOXODATA @l_avrot Finding what you're looking for in directories
- 47. LOXODATA @l_avrot git diff With context Use the wiki pageCreating clean patches Format your git diff output
- 48. LOXODATA @l_avrot But sometimes, even the best men don't follow instructions...
- 49. LOXODATA @l_avrot git diff without context to the left, git diff with context to the right
- 50. LOXODATA @l_avrot 12:27 $ git diff | filterdiff --format=context > ../patch/adding_table_constraint_ description_in_ALTER_TABLE_synopsis_v1.patch
- 51. LOXODATA @l_avrot My submission Use the Wiki pageSubmitting a patch
- 56. LOXODATA @l_avrot And another section was missing!
- 59. LOXODATA @l_avrot ... Now I can die without regret!
- 60. LOXODATA @l_avrot What I learnt Anyone can help (even me!) You can ask for help, you will nd answers It's OK to have multiple refactoring to do (Well, it's quite always the case)
- 61. LOXODATA @l_avrot What next ? Correcting some spelling errors in french translation Studying the code Observing revewing in January Commit fest Proposed conf talks (and got accepted each time for now)
- 62. LOXODATA @l_avrot HOW YOU CAN HELP
- 63. LOXODATA @l_avrot Simple contributor uses PostgreSQL shares your experience answers other users' questions
- 64. LOXODATA @l_avrot Great Contributor Creates/helps organizing user group/Meetup Creates/helps organizing event Invests time/money in PostgreSQL Associations
- 65. LOXODATA @l_avrot Super Contributor Reports bugs Creates patches Reviews patches
- 67. LOXODATA @l_avrot It's all about you You're already a level 1 contributor So, next step ?
- 70. LOXODATA @l_avrot QUESTIONS ? Special thanks to Dimitri, Greg, Vik, Robert and Alvaro for your patience and time Thanks to Frits Ahlefeldt, Freepik, Grzm, Alvaro Herrera, Pixabay and Xkcd.com for illustrations and photos