[gnuastro-commits] master 46f96160 3/3: doc/release-checklist.txt: improved/edited conda-forge instructions

[Mohammad Akhlaghi]

branch: master
commit 46f961608580e463df3ff0f1d397aa25a7bd3d30
Author: Mohammad Akhlaghi <mohammad@akhlaghi.org>
Commit: Mohammad Akhlaghi <mohammad@akhlaghi.org>

    doc/release-checklist.txt: improved/edited conda-forge instructions
    
    Until now, the checklist to confirm the build of Gnuastro on CondaForge
    wasn't actually tested and didn't have all the necessary details.
    
    With this commit, after an application of all the steps in a forked
    repository and confirming the successful build on all CondaForge
    architecture in Gnuastro, the text has been edited and made more clear.
    
    Also, a small typo was corrected in the 'developer-build' script for the
    name of the default compression to use.
    
    The instructions to do a test build on CondaForge were initially provided
    by Sebastian Luna-Valero; thanks a lot Sebastian!
---
 developer-build              |  2 +-
 doc/announce-acknowledge.txt |  3 ++-
 doc/release-checklist.txt    | 38 +++++++++++++++++++++++++++++---------
 3 files changed, 32 insertions(+), 11 deletions(-)

diff --git a/developer-build b/developer-build
index b1889a5a..8f1d3c93 100755
--- a/developer-build
+++ b/developer-build
@@ -47,7 +47,7 @@ reconf=0
 upload=0
 install=0
 valgrind=0
-compression=lz
+compression=lzip
 prefix=/usr/local
 
 
diff --git a/doc/announce-acknowledge.txt b/doc/announce-acknowledge.txt
index d91609b5..edc1dc00 100644
--- a/doc/announce-acknowledge.txt
+++ b/doc/announce-acknowledge.txt
@@ -3,11 +3,12 @@ Alphabetically ordered list to acknowledge in the next 
release.
 Aaron Watkins
 Agata Rożek
 Colin Orion Chandler
-Irene Pintos Castro
+Irene Pintos-Castro
 Rashid Yaaqib
 Raul Infante-Sainz
 Ryan Begley
 S. Zahra Hosseini Shahisavandi
+Sebastian Luna-Valero
 Sepideh Eskandarlou
 Teet Kuumta
 Zahra Sharbaf
diff --git a/doc/release-checklist.txt b/doc/release-checklist.txt
index 522753f0..a8b8192a 100644
--- a/doc/release-checklist.txt
+++ b/doc/release-checklist.txt
@@ -59,6 +59,7 @@ all the commits needed for this release have been completed.
        $ git checkout master
        $ git log --oneline --graph --decorate --all   # For a visual check.
 
+
  - Activate the Conda-forge build to see if the distribution builds on all
    the architectures there.
 
@@ -66,24 +67,43 @@ all the commits needed for this release have been completed.
      recognize 'tar.lz'! Then upload it to a URL that Conda can download
      from:
 
-       $ ./developer-build -p junk; cd build && make dist-xz
-       $ scp gnuastro-X.X.X-XXXX.tar.xz server:location/
+       $ ./developer-build -z xz -p SERVER:LOCATION
+
+   - Get the checksum of the built tarball:
+
+       $ sha256sum build/gnuastro-X.XX.XX-XXXX.tar.xz
+
+   - If you don't already have a Fork of the main CondaForge repository,
+     make one.
+     - Login to https://github.com
+     - Go to https://github.com/conda-forge/gnuastro-feedstock
+     - Click on the "Fork" button and setup a fork.
 
    - Clone the Conda-forge repository for building Gnuastro (change 'XXXX'
-     to the version string); if you already have it, just pull the recent
-     changes.
+     to the version string); if you already have it just pull the recent
+     changes ('git pull'). If you have have already added your fork as a
+     remote, then ignore that step.
 
        $ git@github.com:conda-forge/gnuastro-feedstock.git
        $ cd gnuastro-feedstock
-       $ git checkout -b build-vXXXX
+       $ git remote add fork YOUR-FORK-GIT-LOCATION
+       $ git checkout -b XXXX-dev
        $ emacs recipe/meta.yaml
-       ## Update the URL and SHA256 checksums in the file above
+          --> Completely replace the URL to the one you uploaded to.
+          --> Update the SHA256 checksum to the one you obtained above.
        $ git add -u
        $ git commit
-       $ git push origin build-vXXXX
+       $ git push fork XXXX-dev
+
+   - Once the push is complete, do the pull request (from the link that is
+     printed on the command-line). Afterwards, Github will automatically
+     start a build on all available Conda architectures that Gnuastro has
+     been configured for. This will usually take about half an hour!
+
+   - If there is any problem, you need to fix it. Otherwise (if all the
+     tests pass), you can close the pull request and delete the branch in
+     your fork.
 
-   - Once the push is done, Github will automatically start a build on all
-     available Conda architectures that Gnuastro has been configured for.
 
  - [STABLE] Update the versions in the NEWS file and do a spell-check.