PortsCamp Taiwan

How to contribute to FreeBSD project?

Marcelo Araujo <araujo@FreeBSD.org>Taipei/Taiwan - 2016/01/15

Agenda

● The FreeBSD project’s structure.● Main contributions areas.● How I can become a FreeBSD committer?● What is the benefit to be a FreeBSD committer?● Where I can start?● How about the PortsCamp?

Marcelo Araujo <araujo@FreeBSD.org>Taipei/Taiwan - 2016/01/15

The FreeBSD project’s structure.

Marcelo Araujo <araujo@FreeBSD.org>Taipei/Taiwan - 2016/01/15

9 core Members

376 committers

lots of contributors

The FreeBSD project’s structure.

Marcelo Araujo <araujo@FreeBSD.org>Taipei/Taiwan - 2016/01/15

9 core Members

376 committers

lots of contributors

src: 228

docs: 55

ports: 173

Active committers in the last year (2015).

Marcelo Araujo <araujo@FreeBSD.org>Taipei/Taiwan - 2016/01/15

29

18

17

7

5

Nationalities in this room.

Main contributions areas.

Marcelo Araujo <araujo@FreeBSD.org>Taipei/Taiwan - 2016/01/15

DOCS SRCPORTS

HandBook

Man Pages

Web Resources

FAQ 63 Categories

Framework

Kernel

Userland

How I can become a FreeBSD committer?

Marcelo Araujo <araujo@FreeBSD.org>Taipei/Taiwan - 2016/01/15

FreeBSD Users (many)

FreeBSD Committers

Core Team(9)

Source Trees

src/ ports/doc/ www/

contributions

How I can become a FreeBSD committer?

Marcelo Araujo <araujo@FreeBSD.org>Taipei/Taiwan - 2016/01/15

Submit patches

What is considered?

Marcelo Araujo <araujo@FreeBSD.org>Taipei/Taiwan - 2016/01/15

● Get involved.● Quality and number of patches.● Contribution area.● Commitment with the project.● Work well with the community.● Respect with all individuals within the community.

What is the benefit to be a FreeBSD committer?

Marcelo Araujo <araujo@FreeBSD.org>Taipei/Taiwan - 2016/01/15

● Recognition as a competent software engineer.● Get a chance to work with some of the best engineers in

the world.● Learn new things everyday.● Get an E-rate discount from Gandi.net.● Work experience, your new employer wants that.● Be part of something big that is changing the world.

Where I can start?

Marcelo Araujo <araujo@FreeBSD.org>Taipei/Taiwan - 2016/01/15

● Subscribe to the FreeBSD mailing lists.● Browser the Problem Report database and submit fixes to

bugs or file new entries with fixes.● Adopt a port or create a new one for that cool software.● Translate documentation to your language.● Pick one of the items from the Ideas page.● Subscribe to GSOC. (Students only)

PortsCamp.

Marcelo Araujo <araujo@FreeBSD.org>Taipei/Taiwan - 2016/01/15

● We have 5 ports committers here that can give you some support.○ kevlo@, sunpoet@, vanilla@, lwhsu@ and araujo@.

● When you submit your patch remember to Cc one of these guys above.

PortsCamp.

Marcelo Araujo <araujo@FreeBSD.org>Taipei/Taiwan - 2016/01/15

● All patches that we submit and commit we must add in the history log:

Sponsored by: PortsCamp Taiwan.

● All the PortsCamp is reported to FreeBSD Foundation.

PortsCamp.

Marcelo Araujo <araujo@FreeBSD.org>Taipei/Taiwan - 2016/01/15

● Every VM has poundriere(8) and portlint(1).● Poundriere:

○ PortsTree at: /usr/local/poudriere/ports/local/○ Check dialog config:

poudriere options -j 11-Current -p local -z workstation -f test.pkg

○ Run the test: poudriere bulk -j 11-Current -p local -z workstation -f test.pkg

○ Log result at: /usr/local/poudriere/data/logs/bulk/11-Current-local-workstation/<TIME>/logs/

PortsCamp.

Marcelo Araujo <araujo@FreeBSD.org>Taipei/Taiwan - 2016/01/15

● Check additional info at: https://github.com/FreeBSDTaiwan/portscamp/tree/master/portscamp01

Marcelo Araujo <araujo@FreeBSD.org>Taipei/Taiwan - 2016/01/15

Thank you!