NXDL release 2020.1

[prjemian]

Follow the documented release procedure. Someone other than @prjemian should do this to test that procedure has been fully documented.

These steps:

• rename the NXDL 2019.10 milestone to NXDL 2020.1
• identify and resolve existing issues which can be completed before release during the code camp
• reassign unresolved issues to next milestone
• follow release procedure
• apply lessons learned to release procedure

Note: Any new issues will be assigned to next milestone after this code camp unless they are of immediate nature.

[prjemian]

@PeterC-DLS

There's a checklist at the top of this issue. Perhaps that should become part of the release procedures on the wiki? We're at step 2 on that checklist.

I'm looking at the work queue for the milestone and expecting that most remaining PRs will be complete by Thursday. Now that the release notes scripting is repaired (#735) but work remains to be merged, it's a good time to work the release process again with another R tag: v2020.1rc2.

[prjemian]

Each of the remaining PRs is waiting on one or more reviews. I sent messages to each reviewer yesterday with a request to review by COB Thursday. In one of them, I stated I want to release on Friday. Any unreviewed items will move to next milestone.

[PeterC-DLS]

Ok, I have completed the process for rc2. Please check all it okay.

[prjemian]

One addition is to link to the release notes from the tag comment. See https://github.com/nexusformat/definitions/releases/tag/v2018.5 for an example.

Release notes look good.

Updating the Change History needs to be added to the Release Procedure. The existing page refers to 2019.10 release that should be changed into v2020.1. The contents are hand-selected highlights from the release notes (since important items might be overlooked in the complete release notes).

Fantastic! On Friday, you can do the final release of v2020.1 after completing the checklist above.

Lessons learned

• need linux OS for release process

• need latexmf installed with certain additional fonts

  On Ubuntu xenial, the following packages need to be installed for successful PDF builds:
  texlive-latex-recommended
  texlive-fonts-recommended
  texlive-latex-extra
  latexmk (this is a Sphinx requirement on GNU/Linux and MacOS X for functioning of make latexpdf)

• can build complete (HTML& PDF) manual with make all in root directory

Anything else?

[prjemian]

One more lesson learned Preparatory step Get a GitHub personal access token, read only for access to repos, milestones, pull requests, issues, ... This is specific to the user for use on one workstation

…

On Tue, Jan 28, 2020, 9:44 AM Peter Chang ***@***.***> wrote: Ok, I have completed the process for rc2. Please check all it okay. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#693?email_source=notifications&email_token=AARMUMB5KH4BCQ4SM4BNTGDRABHFDA5CNFSM4JKYJSF2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOEKDZP4A#issuecomment-579311600>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AARMUMF63F6OFXTWWTEN62LRABHFDANCNFSM4JKYJSFQ> .

[PeterC-DLS]

On Fedora 31, need to install:

• make hdf5-devel python-matplotlib python-lxml python3-sphinx-latex latexmk
• h5py=2.10.0
• pyRestTable
• pygithub
• sphinx==2.3.1

[prjemian]

@PeterC-DLS we are ready now for release v2020.1

[prjemian]

I just checked off items 2 & 3 in the check list above.

[PeterC-DLS]

Ok, I will proceed with release.

[PeterC-DLS]

All done up to and including step 13 so please check. I will be off-line so I will leave the last two steps to you.

[prjemian]

Thanks. Changed the release name to "v2020.1"

…

On Fri, Jan 31, 2020, 7:34 AM Peter Chang ***@***.***> wrote: All done so please check. I will be off-line so I will leave the mailing list announcement to you. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#693?email_source=notifications&email_token=AARMUMHIH6ELU3JLGR5UWNTRAQSH3A5CNFSM4JKYJSF2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOEKOVC3Q#issuecomment-580735342>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AARMUMBZYPGSMQYRCBBVZS3RAQSH3ANCNFSM4JKYJSFQ> .