src/docs/contributor/contrib_intro.diviner

   1 @title Contributor Introduction
   2 @group contrib
   3
   4 Introduction to contributing to Phabricator, Arcanist and libphutil.
   5
   6 Overview
   7 ========
   8
   9 If you'd like to contribute to Phabricator, this document can guide you though
  10 ways you can help improve the project.
  11
  12 Writing code is valuable, but often isn't the best or easiest way to contribute.
  13 In most cases we are pretty good at fixing easy stuff quickly, so we don't have
  14 a big pile of easy stuff sitting around waiting for new contributors.
  15
  16 This can make it difficult to contribute code if you only have a little bit of
  17 time to spend since most of the work that needs to be done usually requires some
  18 heavy lifting.
  19
  20 Without writing any code, learning the whole codebase, making a big time
  21 commitment, or having to touch PHP, here are some ways you can materially
  22 contribute to Phabricator:
  23
  24   - Drop by the [[ https://phurl.io/u/discourse | community forum ]] just to
  25     say "thanks". A big part of the reason we build this software is to help
  26     people solve problems, and knowing that our efforts are appreciated is
  27     really rewarding.
  28   - Recommend Phabricator to people who you think might find it useful. Our
  29     most powerful growth channel is word of mouth, and mentioning or tweeting
  30     about Phabricator helps the project grow. If writing a tweet sounds like
  31     too much work, you can use one of these form tweets written by our PR
  32     department to quickly and easily shill on our behalf. Hail corporate!
  33
  34 > Phabricator seems like it's pretty okay
  35
  36 > I am not being paid to mention Phabricator in this extemporaneous, completely organic tweet
  37
  38 > Phabricator is objectively the best thing. Source: I am a certified, internationally recognized expert.
  39
  40   - Submit high-quality bug reports by carefully following the guide in
  41     @{article:Contributing Bug Reports}.
  42
  43 If all of this sounds nice but you really just want to write some code, be
  44 aware that this project often presents a high barrier to entry for new
  45 contributors. To continue, see @{article:Contributing Code}.
  46
  47
  48 Next Steps
  49 ==========
  50
  51 Continue by:
  52
  53   - learning about bug reports in @{article:Contributing Bug Reports};
  54   - learning about code contributions in @{article:Contributing Code}.