
Developing for gocept.jsform
============================

Installation::

  $ npm install
  $ grunt

To run tests in a browser, run::

  $ grunt test

To run tests in phantomjs, run::

  $ grunt phantomjs


Documentation
=============

The documentation is written in Sphinx and located under doc. There is a
Makefile that helps you generate the documentation from the sources. You'll
need to install sphinx globally or adjust the path inside the Makefile to your
needs.

Build the documentation with::

    $ cd docs && make html
    $ open index.html

You can install the Sphinx package in your site packages or virtual environment
using pip::

    $ pip install sphinx
    $ pip install sphinxcontrib-autoanysrc


Releases
========

  * Run `grunt bump` or `grunt bump:major` to increase version.
  * Update Changelog (e.g. remove "unreleased").
  * Run `grunt run:docs` to build documentation for this new release.
  * Upload to readthedocs. (XXX How???)
  * Commit changes to github.
  * Create a tag for the current version:
        * git tag -a X.X.X -m "Version X.X.X"
        * git push origin X.X.X
  * Run `grunt bump:prerelase`.


Developing for gocept.jsform
============================

Installation::

  $ npm install
  $ grunt

To run tests in a browser, run::

  $ grunt test

To run tests in phantomjs, run::

  $ grunt phantomjs


Documentation
=============

The documentation is written in Sphinx and located under doc. There is a
Makefile that helps you generate the documentation from the sources. You'll
need to install sphinx globally or adjust the path inside the Makefile to your
needs.

Build the documentation with::

    $ cd docs && make html
    $ open index.html

You can install the Sphinx package in your site packages or virtual environment
using pip::

    $ pip install -r docs/requirements.txt


Releases
========

  * Run `grunt bump` or `grunt bump:major` to increase version.
  * Update Changelog (e.g. remove "unreleased").
  * Run `grunt run:docs` to build documentation for this new release.
  * Upload to readthedocs. (XXX How???)
  * Commit changes to github.
  * Create a tag for the current version:
        * git tag -a X.X.X -m "Version X.X.X"
        * git push origin X.X.X
  * Run `grunt bump:prerelase`.

Update install guide for Sphinx
Update install guide for Sphinx
