Index: openacs-4/packages/acs-core-docs/www/releasing-openacs-core.adp =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/releasing-openacs-core.adp,v diff -u -r1.6.2.7 -r1.6.2.8 --- openacs-4/packages/acs-core-docs/www/releasing-openacs-core.adp 27 Apr 2022 16:52:20 -0000 1.6.2.7 +++ openacs-4/packages/acs-core-docs/www/releasing-openacs-core.adp 13 Jul 2023 12:43:22 -0000 1.6.2.8 @@ -1,19 +1,20 @@ -{/doc/acs-core-docs {ACS Core Documentation}} {OpenACS Core and .LRN} +{/doc/acs-core-docs/ {ACS Core Documentation}} {OpenACS Core and .LRN} OpenACS Core and .LRN

OpenACS Core and .LRN

  1. -Update Translations. the section called “How to Update -the translations” +Update Translations. the section called +“How to Update the +translations”

  2. Rebuild the Changelog. Rebuild the @@ -42,24 +43,27 @@ /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/acs-core-docs/www/xml/variables.ent with the new version number.

  3. Add new section in /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/acs-core-docs/www/xml/for-everyone/release-notes.xml

  4. -

    Regenerate all HTML docs

    cd /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/acs-core-docs/www/xml
    -make
    +

    Regenerate all HTML docs

    +cd /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/acs-core-docs/www/xml
    +make
    +
  5. Update /var/lib/aolserver/$OPENACS_SERVICE_NAME/readme.txt with the new version number

  6. Update version number and release date in all of the core packages. Use /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/acs-core-docs/www/files/update-info.sh with the new version number and the release date as arguments. Run -it from /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages:

    cd /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages
    +it from /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages:

    +cd /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages
            ./acs-core-docs/www/files/update-info 5.2.12006-01-16
     
  7. Install a new site using the modified code and verify that the automated tests pass.

  8. Commit changes to CVS

  • -Tag the files in CVS. The steps to this -point should have ensured that the head of the current branch +Tag the files in CVS. The steps to +this point should have ensured that the head of the current branch contains the full set of code to release. Now we need to tag it as the code to be released.

    1. @@ -91,7 +95,8 @@ feature freeze. Branching is almost the same as tagging, except for the flag and slightly different tag nomenclature. To see the list of old branches, cvs status -v -somefile.

      cvs tag -b oacs-5-0
      +somefile.

      +cvs tag -b oacs-5-0
       

    If doing .LRN: Since the .LRN packages aren't all in one module, we iterate through all of the modules. Log in first (cvs @@ -158,25 +163,27 @@

  • -Test the new tarball(s). Download the -tarballs just created and install them and make sure everything +Test the new tarball(s). Download +the tarballs just created and install them and make sure everything looks okay and that automated tests pass.

  • -Update Web site. Update the different -places on OpenACS.org where we track status.

      +Update Web site. Update the +different places on OpenACS.org where we track status.

      • Release Status for the current version - something like http://openacs.org/projects/openacs/5.0/milestones

      • Home page of openacs.org

      • Post a new news item

    • -Clean Up. Clean up after yourself.

      cd /var/tmp
      +Clean Up. Clean up after
      +yourself.

      cd /var/tmp
       rm -rf tarball dotlrn-tarball dotlrn-packages openacs-5.0.0a1
       rm -rf /var/tmp/openacs-4

    Here is a shell script that automates packaging the tarball (it's a bit out of date with the new steps - I've been doing everything manually or with little throwaway scripts as -detailed above until the process is stabilized).

    #!/bin/bash
    +detailed above until the process is stabilized).

    +#!/bin/bash
     
     # if TAG=1 create the cvs tags otherwise assume they exist.
     TAG=1
    @@ -261,8 +268,8 @@
     2020/07/02 08:39:25 gustafn Exp $)