Documentation/community/services.md

   1 # Accounts on coreboot.org
   2
   3 There are a number of places where you can benefit from creaating an account
   4 in our community. Since there is no single sign-on system in place (at this
   5 time), they come with their own setup routines.
   6
   7 ## Gerrit code review
   8 We exchange and review patches to the code using our [Gerrit code review
   9 system](https://review.coreboot.org).
  10
  11 It allows logging in with a Google or GitHub account using OAuth2 as well
  12 as with any OpenID provider that you may already use.
  13
  14 On the [settings screen](https://review.coreboot.org/settings) you can register
  15 all your email addresses you intend to use in the context of coreboot
  16 development so that commits with your email address in them are associated with
  17 you properly.
  18
  19 ### https push access
  20 When using the https URLs to git repositories, you can push with the "HTTP
  21 Credentials" you can have Gerrit generate for you on that page. By default,
  22 git uses `$HOME/.netrc` for http authentication data, so add a line there
  23 stating:
  24
  25     machine review.coreboot.org login $your-user-name password $your-password
  26
  27 ### Gerrit user avatar
  28 To setup an avatar to show in Gerrit, clone the avatars repository at
  29 https://review.coreboot.org/gerrit-avatars.git and add a file named
  30 $your-user-ID.jpg (the user ID is a number shown on the [settings screen](https://review.coreboot.org/settings)).
  31 The image must be provided in JPEG format, must be square and have at most 50000
  32 bytes.
  33
  34 After you push for review, the system will automatically verify your change
  35 and, if adhering to these constraints, approve it. You can then immediately
  36 submit it.
  37
  38 ## Issue tracker
  39 We have an [issue tracker](https://ticket.coreboot.org) that is used for
  40 coreboot and related code, such as libpayload, as well as for the project's
  41 infrastructure.
  42
  43 It can be helpful to refer to issues we track there in commit messages:
  44
  45     Fixes: https://ticket.coreboot.org/issues/$id