ocrd-galley/README-DEV.md

How to add a processor
----------------------
* Add model download to `build` (if necessary)
* Add a Dockerfile
* Add commands to `wrapper/qurator/ocrd_galley/cli.py`

Releasing
---------
* `git tag -m 'v<version>' 'v<version>'`
* `for r in origin github github-qurator-spk; do git push -d $r stable; done`
* `git tag -fm 'stable' 'stable'`
* `for r in origin github github-qurator-spk; do git push --tags $r master; done`
  * This - the tags - triggers Travis builds for the mikegerber repo,
    including building the Docker images and pushing them to Docker Hub.
  * Make sure that qurator-spk gets tags pushed (for consistency).
* Create release on GitHub

Inclusion policy
----------------
1. Only use PyPI version where possible.
2. If that is not possible (= available) use a versioned release from GitHub
3. Otherwise, use a GitHub commit

If, for some reason, we must deviate from this, to e.g. hotfix something, an
issue should be open that reminds us to go back to a versioned release again.

Other than relying on "proper releases", this also has a second purpose: Review
releases of qurator-spk releases.


Test builds
-----------
```
GIT_COMMIT=test ./build Dockerfile-core Dockerfile-ocrd_tesserocr
DOCKER_IMAGE_TAG=test ./test-ocrd_tesserocr.sh
```

To test the GitHub Action builds:

```
# by branch
# Note that these only get tagged if *all* the builds succeeded and ran their
# tests successfully
export DOCKER_IMAGE_TAG=master

# by git commit id
# these work even if other processors did not succesfully build (or ran their
# tests successfully)
export DOCKER_IMAGE_TAG=sha-af6da489e24c9ba7828114b546610b0d70116ba4
```