venzone-1.1.1.1: CONTRIBUTING

===========================================
If you want to contriubute to the source
code of venzone you are in the right
place. If you want to design levels inste-
ad, check the guide at `stories/editor.vns`
===========================================


0. Get haskell, via your system repositories or

     https://www.haskell.org/ghcup/

1. Check the code at

     http://www.ariis.it/static/repos/stagit/venzone

   and follow instructions in there to clone it.

2. Modify the game, add features.

    lentil src/ test/ # to see open issues
    # no lentil? `cabal new-install lentil` to get it.

3. If needed, update your package list:

    cabal update

4. Build your executable:

    cabal build venzone
    # when it finishes, you will find your executable in `release/`.
    # Use --allow-newer if cabal cannot solve the dependency tree

5. Run the tests with:

    cabal run test

    # if you want to watch the replay of a specific test, do
    `cabal new-repl test` and then
    λ> narrateGymnasium "test/records/ladder-exit.vr"

6. Upload your modifications somwehere (gitlab, sourcehout, …) and
   send me a message (<fa-ml@ariis.it>) so I can pull them.

7. If you compiled venzone for a new system and want to send me a release
   of it just type:

    cabal new-run -f crea-release packerino

   and a .zip will be automatically created.


Stuck? don't hesitate to contact me:

    http://ariis.it/static/articles/mail/page.html