src/docs/user/introduction.diviner

   1 @title Introduction
   2 @group intro
   3
   4 This document provides a high-level overview of the Phabricator project.
   5
   6 = What is Phabricator? =
   7
   8 **Phabricator** (pronounced like the word //fabricator//) is a suite of web
   9 applications which make it easier to build software, particularly when working
  10 with teams. Phabricator is largely based on Facebook's internal tools.
  11
  12 The major components of Phabricator are:
  13
  14   - **Differential**, a code review tool; and
  15   - **Diffusion**, a repository browser; and
  16   - **Maniphest**, a bug tracker; and
  17   - **Phriction**, a wiki.
  18
  19 Phabricator also includes a number of smaller tools.
  20
  21 = Why use Phabricator? =
  22
  23 Phabricator gives you a box of solid tools for a comparatively small setup cost.
  24 The tools all work together and are richly integrated. The whole thing is free
  25 and open source. You own all your data. Phabricator is extremely fast and proven
  26 to scale both to large datasets (Facebook has 500,000+ commits across many
  27 repositories) and large organizations (Facebook has 500+ fulltime engineers).
  28 Phabricator's tools are easy to learn, understand, and use.
  29
  30 However, Phabricator may also not be a good solution for you:
  31
  32   - If you develop primarily on Windows, you are likely to find integration
  33     with the toolsets you use lacking.
  34   - If you don't use SVN, Git or Mercurial, you'll have to add support for your
  35     VCS before you can get anywhere.
  36   - If you loathe PHP, well, it's written in PHP. Sorry. It is a victim of
  37     circumstances. We assert it is well-written PHP, at least.
  38
  39 = Next Steps =
  40
  41 Continue by:
  42
  43   - installing Phabricator with the @{article:Installation Guide}.