docs/index.rst @ 5d26872c0260 initial-docs

docs: add more structure to the skeleton
author Steve Losh <steve@stevelosh.com>
date Mon, 14 Jun 2010 21:09:16 -0400
parents 480c971af727
children 68b8187e26b1
.. hg-review documentation master file, created by
   sphinx-quickstart on Mon Jun 14 20:39:45 2010.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

hg-review documentation
=======================

hg-review is a `Mercurial <http://hg-scm.org>`_ extension for performing
distributed code review.

Quickstart
----------

If you're impatient and want to play with hg-review right away, here's what you
need to do.

First, clone the extension somewhere::

    hg clone http://bitbucket.org/sjl/hg-review/

Then add it to your ``~/.hgrc`` file::

    [extensions]
    review = [path to]/hg-review/review/

Now you need a repository that has code review enabled.  Luckily, you've
already got one -- hg-review uses itself for code review.

``cd`` into the directory you cloned hg-review to and initialize the review
data::

    cd hg-review
    hg review --init

Start the web interface::

    hg review --web

Open http://localhost:8080/ in your browser of choice and poke around.

Check out the :doc:`Overview </overview>` when you're ready to learn more.

User's Guide
------------

.. toctree::
   :maxdepth: 2

   overview
   concepts
   webui
   cli

Developer's Guide
-----------------

.. toctree::
   :maxdepth: 2

   api

Indices and tables
------------------

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`