Ignore:
Timestamp:
9 Mar 2012, 07:27:06 (13 years ago)
Author:
Henrik Bettermann
Message:

Update docs.

Location:
main/waeup.custom/trunk/docs/source/developerdocs
Files:
1 deleted
2 edited

Legend:

Unmodified
Added
Removed
  • main/waeup.custom/trunk/docs/source/developerdocs/developernotes.rst

    r6489 r7823  
    22***************
    33
    4 How to setup a developer instance of the WAeUP SIRP, handle tests, docs
     4How to setup a developer instance of the WAeUP Kofa, handle tests, docs
    55etc.
    66
    7 The new WAeUP SIRP is based on `Grok <http://grok.zope.org/>`_.
     7The new WAeUP Kofa is based on `Grok <http://grok.zope.org/>`_.
    88
    99Installing a developer copy
     
    1515--------------------
    1616
    17 To create a working copy of the WAeUP SIRP we recommend use of
     17To create a working copy of the WAeUP Kofa we recommend use of
    1818`virtualenv`. You, however, need also some basic libraries, a C
    1919compiler and some things more.
     
    127127In the sandbox (or anywhere else) we now create our real working
    128128environment. To do this, we change to the sandbox and checkout the
    129 sources of the WAeUP SIRP from the subversion server::
     129sources of the WAeUP Kofa from the subversion server::
    130130
    131131  $ cd mysandbox/
    132   $ svn co https://svn.waeup.org/repos/main/waeup.sirp/trunk waeup-trunk
     132  $ svn co https://svn.waeup.org/repos/main/waeup.kofa/trunk waeup-trunk
    133133
    134134where ``waeup-trunk`` is only a name we've chosen here to make clear
     
    194194=============
    195195
    196 With the :mod:`waeup.sirp` package we try to reach high standards in
     196With the :mod:`waeup.kofa` package we try to reach high standards in
    197197both, documentation and testing.
    198198
    199 :mod:`waeup.sirp` makes extensive use of doctests, which this way also
     199:mod:`waeup.kofa` makes extensive use of doctests, which this way also
    200200become both: executable (i.e. testable) examples and documentation.
    201201
     
    206206documentation generator to generate the docs as HTML pages.
    207207
    208 The documentation of the :mod:`waeup.sirp` project can easily be
     208The documentation of the :mod:`waeup.kofa` project can easily be
    209209created doing::
    210210
     
    212212
    213213This will create a tree of HTML pages in
    214 ``parts/waeupdocs/waeup.sirp/build/waeup.sirp/`` which you can for
     214``parts/waeupdocs/waeup.kofa/build/waeup.kofa/`` which you can for
    215215instance browse by pointing your browser to this location.
    216216
     
    223223
    224224means explaining to other developers what your code does and test it
    225 at the same time. See the many .txt files in the :mod:`waeup.sirp`
     225at the same time. See the many .txt files in the :mod:`waeup.kofa`
    226226package for examples.
    227227
     
    230230=======
    231231
    232 Tests are most important to the reliability of the :mod:`waeup.sirp`
     232Tests are most important to the reliability of the :mod:`waeup.kofa`
    233233package. We don't tell someone that our code works, if we cannot prove
    234234it. And we prove it by testing.
     
    246246  $ bin/test -c
    247247
    248 We have many tests in the :mod:`waeup.sirp` package so that sometimes
     248We have many tests in the :mod:`waeup.kofa` package so that sometimes
    249249you only want the functional *or* the unit tests to run. This can be
    250250done like this::
     
    277277
    278278  Most unit tests furthermore declare that they want to be run inside
    279   the `WAeUPSIRPUnitTestLayer` defined in `waeup.sirp.testing`. This
    280   layer groks the whole `waeup.sirp` package, so that all ZCA
     279  the `WAeUPKofaUnitTestLayer` defined in `waeup.kofa.testing`. This
     280  layer groks the whole `waeup.kofa` package, so that all ZCA
    281281  components are already setup when you start your tests.
    282282 
     
    284284  layer, the testfile has to provide the following line::
    285285
    286     .. :layer: waeup.sirp.testing.WAeUPSIRPUnitTestLayer
     286    .. :layer: waeup.kofa.testing.WAeUPKofaUnitTestLayer
    287287
    288288  Use it, if in your tests you make use of registered components like
  • main/waeup.custom/trunk/docs/source/developerdocs/index.rst

    r6488 r7823  
    77   developernotes
    88   api/index
    9    german/index
Note: See TracChangeset for help on using the changeset viewer.