User:Maffblaster/Drafts/Gentoo Primers/The Gentoo Developer Primer

This document should not be considered a replacement for the old Developer Handbook. Eventually this article may get merged into the Developer Handbook. Right now it is simply to be used as a draft space of steps necessary for developers to become connected and productive in the Gentoo sphere. New developers should travel down through the list.

Developer init
New developers have quite a few things to setup before they're 'fully integrated' into the Gentoo ecosystem. For developers that are unfamiliar with processes and job duties of system administration (perhaps more code-savvy and less infrastructure oriented developers), configuring these things can be a confusing and difficult. Because of the sheer amount of tasks, it's also easy to

SSH
SSH keys will need to be generated. The recruiter(s) will assist in this process, but essentially:

Master keys
It is best practice to generate a master key pair, then generate some subkeys from that pair.

Subkeys
Signing keys.

Woodpecker
Woodpecker is primary used to setup a developer's LDAP information and add developer mail addresses to email alaises. These changes are actioned using the script.

Each change will require you to enter a password.

LDAP
LDAP is used in order to maintain Gentoo internal information about developers.

To add yourself to some roles for Gentoo, execute the following command:

Although you can name them whatever you'd like, your roles should match your project affiliations defined on by your project involvement.

Set lon/lat (look where you're located at here):

GPG key
expects the GPG signing key to be passed in fingerprint format. The following command will show the fingerprint format for subkeys:

In the above example  is the signing key in the fingerprint format.

Wiki
Visit the Developer Central page and click the "Getting started" link in order to connect your LDAP information to the wiki.

IRC
Most developers stay connected 24/7 to IRC in order to catch any mentions of their nickname. There are various strategies of staying connected. Some developers leave their main workstation connected to the internet, others might pay for an IRC cloud service.

For those wishing to do things themselves, the IRC guide is a great place to start.

Forums

 * Create a forums account (optional).

Blog
May Gentoo developers have blogs. This section will present a few options for Gentoo developers.

The first option is Developer website on Woodpecker.

Second is Wordpress, via https://blogs.gentoo.org.

If none of these options work, you can always host the blog somewhere else. As long as it has an RSS feed, Gentoo Planet can pull in the Gentoo related postings.

Portage configuration
Package maintainers will need to provide Portage with their GPG signing key information in 0xlong format. This is a different format than expects on Woodpecker. Use the following command to display keys in the proper format:

In this example  is the part that would be copied into.

Tooling
When attempting to preform fine work, having sharp, precise tools is a must. This section of the developer primer will hopefully provide aid in helping developers streamline their workflow. The goal is an increase in productivity.

Shell configuration
zsh

Email clients
Depending on the desired email clients, getting setting configured properly to filter incoming messages into nicely organized directories and remove nasty spam can take some time.

Thunderbird
Useful link for spam filtering:


 * https://support.mozilla.org/en-US/kb/thunderbird-and-junk-spam-messages

Remember that Mozilla's spam filter needs training, so it may take some time (a week or two) for it to learn what is spam what is not. Be sure to check whatever folder is dedicated to Junk every once in a while to be sure important messages are not being marked as Junk!