drone: cleanup and docs, packaging special branch

.drone.yml

@@ -18,6 +18,7 @@ name: docs
 trigger:
   branch:
     exclude:  # special branches
+    - packaging
     - pip
     - conda
     - deploy-pip
@@ -93,6 +94,7 @@ trigger:
   branch:
   - release
   - candidate
+  - packaging
   - pip
   - deploy-pip
 
@@ -123,6 +125,7 @@ steps:
   when:
     branch:
     - candidate
+    - packaging
     - pip
   commands:
   - bash maintenance/pip/upload_wheels.sh testing
@@ -157,6 +160,7 @@ trigger:
   branch:
   - release
   - candidate
+  - packaging
   - pip
   - deploy-pip
 
@@ -214,6 +218,7 @@ steps:
   when:
     branch:
     - candidate
+    - packaging
     - pip
   commands:
   - bash maintenance/pip/upload_wheels.sh testing
@@ -247,6 +252,7 @@ name: tests-base
 trigger:
   branch:
     exclude:  # special branches
+    - packaging
     - pip
     - conda
     - docs
@@ -305,6 +311,7 @@ name: tests-gf
 trigger:
   branch:
     exclude:  # special branches
+    - packaging
     - pip
     - conda
     - docs
@@ -361,6 +368,7 @@ name: tests-examples
 trigger:
   branch:
     exclude:  # special branches
+    - packaging
     - pip
     - conda
     - docs
@@ -417,6 +425,7 @@ name: tests-gui
 trigger:
   branch:
     exclude:  # special branches
+    - packaging
     - pip
     - conda
     - docs
@@ -473,6 +482,7 @@ name: tests-windows
 trigger:
   branch:
     exclude:  # special branches
+    - packaging
     - pip
     - conda
     - docs
@@ -548,6 +558,7 @@ name: tests-osx-arm64
 trigger:
   branch:
     exclude:  # special branches
+    - packaging
     - pip
     - conda
     - docs
@@ -624,6 +635,7 @@ trigger:
   branch:
   - release
   - candidate
+  - packaging
   - pip
   - deploy-pip
 
@@ -655,6 +667,7 @@ steps:
   when:
     branch:
     - candidate
+    - packaging
     - pip
   commands:
   - pip install twine
@@ -702,6 +715,7 @@ depends_on:
 trigger:
   branch:
     exclude:  # special branches
+    - packaging
     - pip
     - conda
     - docs
@@ -743,6 +757,7 @@ name: conda-packages-linux
 trigger:
   branch:
     - candidate
+    - packaging
     - release
     - conda
     - deploy-conda
@@ -760,6 +775,7 @@ steps:
   when:
     branch:
       - candidate
+      - packaging
       - conda
 
 - name: build-test-upload
@@ -786,6 +802,7 @@ name: conda-packages-osx-64
 trigger:
   branch:
     - candidate
+    - packaging
     - release
     - conda
     - deploy-conda
@@ -803,6 +820,7 @@ steps:
   when:
     branch:
       - candidate
+      - packaging
       - conda
 
 - name: build-test-upload
@@ -829,6 +847,7 @@ name: conda-packages-osx-arm64
 trigger:
   branch:
     - candidate
+    - packaging
     - release
     - conda
     - deploy-conda
@@ -845,6 +864,7 @@ steps:
   when:
     branch:
       - candidate
+      - packaging
       - conda
 
 - name: build-test-upload
@@ -878,6 +898,7 @@ name: conda-packages-windows
 trigger:
   branch:
     - candidate
+    - packaging
     - release
     - conda
     - deploy-conda
@@ -893,6 +914,7 @@ steps:
   when:
     branch:
       - candidate
+      - packaging
       - conda
 
 - name: build-test-upload
@@ -927,6 +949,7 @@ trigger:
   branch:
     - app
     - candidate
+    - packaging
     - release
 
 steps:

CONTRIBUTING.md

@@ -23,16 +23,35 @@ Drone CI tests are run on any commits pushed to the repository. By default,
 flake8 is run, tests are run parallel in 4 groups, test coverage is measured,
 and docs are built. Success/failure is reported to the Pyrocko Hive.
 
+Build artifacts are uploaded to staging area at
+https://data.pyrocko.org/builds/
+
 Pushing to specific branches triggers extra pipelines:
 
+**Special tests**
+
 * `hptime`: tests are run in both time handling modes (double test time)
-* `pip`: pip wheels and sdist are built, tested and uploaded to
-  PyPi-testing
-* `conda`: anaconda packages are built and tested
+
+**Releasing**
+
+* `candidate`: run all tests + hptime tests, package, test built packages
+  and upload to testing area of conda/pip
+* `release`: build packages and publish, tests and package tests are skipped
+
+**Debugging package builds and docs generation**
+
+* `docs`: build docs and upload to staging area for inspection
+* `pip`: build pip wheels and sdist, test them and upload to PyPI testing
+* `conda`: anaconda packages are built
+* `app`: build OSX app and upload to staging area
+* `packaging`: build all packages (almost like `candidate` but skip normal
+  testing)
+
+**Selective deployment (for hotfixing)**
+
 * `deploy-docs`: docs are published
-* `candidate`: same as pip + anaconda + hptime
-* `release`: same as pip + anaconda + deploy-docs, packages are additionally
-  published and package tests are skipped
+* `deploy-pip`: build and publish pip packages
+* `deploy-conda`: build and publish conda packages
 
 ## Versioning and releases