Page History

...

The previous actions will have checked out the release tag into the target directory under [dspace-src]/target/checkout/dspace/. Navigate to that directory and execute the creation of the distributions using the following command. This will create two zip, two bzip and two gzipped files in the target directory. One set of files is the "binary" release, and the other set is the source release.

...

• From the GitHub UI, visit: https://github.com/DSpace/DSpace/tags
• Find the newly tagged release & click on "Add Release Notes"
• Add in some basic release notes (refer to prior versions for some standard text).  Please be sure to provide the following information:
  • A link to the Wiki Release Notes (in the DSDOC area)
  • A link to the general documentation for this release (again in the DSDOC area)
• Upload the distribution files and a PDF export of the documentation. There should be 5 7 total files attached:
  • dspace-[version]-release.tar.gz
  • dspace-[version]-release.tar.bz2
  • dspace-[version]-release.zip
  • dspace-[version]-src-release.tar.gz
  • dspace-[version]-src-release.tar.bz2
  • dspace-[version]-src-release.zip
  • DSpace-Manual.pdf
• When you are satisfied, publish the new release!

...

• Add the new contributors to the list: DSpaceContributors
• Coordinate Announcements with DuraSpace Staff:
  
  • You might send draft announcements to the dspace-release devel mailing list for review.
  • Announcement on dspace.org, duraspace.org, twitter
  • Ensure that the Latest Release page on dspace.org is updated.
    
    • Plus, ask dspace.org admins to upload latest documentation in PDF/HTML format
  • Announce on all DSpace mailing lists
  • Link announcement on Home of DSpace Wiki, change any version numbers listed on that page.
• Update Wiki pages, particularly these pages which refer to the Current and Next Releases:
  
  • Current Release
  • Next Release Status
  •  Releases
  • NOTE: See DSpace Wiki Style Guide for notes on how to actually edit the above Redirect pages
• Also, update the Documentation Wiki area! Specifically:
  
  • All Documentation page -> Has current release info
  • Add a warning to the documentation of the newest unsupported release (e.g. the warning for DSpace 1.7) and link to our Support Policy.
    Spaces - Space directory - (i) next to the space - Space Admin - Themes - Configure Theme - Header 
  • Homepage for the current Documentation (e.g. DSpace 46.x Documentation) -> Has links to download latest version of DSpace
  • Update the database schema diagram
• For major releases, create a new branch in GitHub for any upcoming bug-fix releases:
  
  • E.g., after the 3.0 release, we created a 3.x branch for any subsequent bug fix releases.
  • To automatically create a branch, you may be able to use the release:branch command (NOTE: untested, but it should work! once we test it out, this may be the best practice way of creating a branch).

  • To manually create a branch, run commands similar to:

    Code Block
    language bash
    git clone git@github.com:DSpace/DSpace.git branchit cd branchit git checkout -b dspace-3_x dspace-3.0 git push --set-upstream origin dspace-3_x

    
    

  • Then, go back to your master checkout, and make sure to update its version numbers in the pom.xml files by running the following:

    Code Block
    git checkout master mvn release:update-versions -Dmirage2.on

    (Remember to enter in the next appropriate major version number. E.g. After releasing 3.0, master should be updated to "4.0-SNAPSHOT", while the new 3_x branch should be at "3.1-SNAPSHOT")

  • NOTE: the update-versions command doesn't always work perfectly. You will want to try a complete rebuild of DSpace before committing anything, as it sometimes misses updating a few version numbers.
  • Push your verified changes back to GitHub.
  • You'll also need to ensure that all version numbers and the <scm> section is appropriate in the pom.xml files of your new Branch. Remember, the <scm> configurations should point at the branch, rather than back at master.
• Updates to JIRA:
  
  • Move any uncompleted issues to the next DSpace version tag in JIRA.
  • Ask a JIRA Administrator to close out the release in JIRA (this will ensure no new issues can be added to that release).
• Updates to GitHub:  Move any uncompleted PRs to the next DSpace version tag.
• Find the number of contributors (helpful data for the announcement, you are drafting an announcement, right?): for bugfix releases, it's: git shortlog -ns branch_name_goes_here ^master | wc -l

...