Changes between Version 27 and Version 28 of DevNotes/Processeses/DeploymentProcess


Ignore:
Timestamp:
Feb 10, 2019 9:29:44 PM (8 months ago)
Author:
butler
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • DevNotes/Processeses/DeploymentProcess

    v27 v28  
    5151   * Windows: `setupSasView-V.v.v-x64.exe` 
    5252   * mac: `SasView-V.v.v-MacOSX.dmg` 
    53  * The portion of the release notes in the RELEASE.rst for this new release version should be entered in the Release Description section (i.e do not copy the full release notes which includes notes for ALL previous versions as well). Also a copy of the ''Acknowledgment and citation'' and ''Bug Reporting'' sections should be included at the end of the Release Description section. 
    54 === update posted documentation === 
    55 Currently we maintain both an html and a PDF copy of the documentation available on the !SasView website. Make sure to follow '''BOTH''' steps below.  
    56  * The documentation folder contents (html version) needs to be moved to the sasview.github.io repo under `/docs`. 
    57   * The first step it to git create a new folder (docs_x.y.z) under `docs/old_docs` where x.y.z is the version number being superseded (i.e. the version of the docs currently in the repo). 
    58   * Git move all the folders and files currently under docs to `docs/old_docs/docs_x.y.z` 
    59   * Git copy the new html docs (all folders and files) to `docs` 
    60     * '''NOTE:''' While the docs could be built locally, for consistency with the release docs it is strongly recommended that the release version be installed locally and the cocs copied from the install path. These can just be git copied into the github.io repo folder. 
    61   * Commit and push these changes 
    62  * The documentation is also built as a PDF and the PDF link for the website also needs to be updated to the new PDF version. 
    63    * Again, the first step is to git move the !SasViewDocumentation.pdf to downloads/Old_SasViewDoucmentation/ 
    64    * The new PDF is available on the Jenkins Master Build tab of the OSX and Ubuntu builds only. **NOTE:** they are **not** currently available in any of the release builds which means they should be downloaded from Mater build immediately after last commits before tagging a release.  This should be changed to add a PDF build on the release servers at some point. 
    65    * PDF should be downloaded as !SasViewDocumentation.pdf. 
    66    * The pdf should then be git copied or git moved to the sasview.github.io/downloads folder. 
    67    * Commit and push changes 
     53 * The portion of the release notes in the RELEASE.rst for this new release version should be entered in the Release Description section (i.e do not copy the full release notes which includes notes for ALL previous versions as well). Also a copy of the ''Acknowledgment and citation'' and ''Bug Reporting'' sections should be included at the end of the Release Description section... with the correct DOI and version numbers of course. 
    6854== Final release steps == 
    6955 * The release manager will email the team to announce the release process is complete. 
    7056 * The team should download the new release to make sure it installs. Because the release build servers are different than the developer build servers, build server fixes and dependency updates may not have been propagated over to the release server so some rudimentary testing should be done to double check that all is well. 
    7157 * Once final approval is given 
     58   * Update the github release page to remove the `pre-release` tag which will make this now the current release found by !SasView web pages. 
    7259   * The release number should be updated in latestversion.json on the !SasView website repo which will alert all !SasView users that a new version is available. 
    73    * Update the github release page and remove the pre-release tag 
     60   * Finally update the website links to the documentation to point to the new versions - see next steps 
    7461 
     62=== update posted documentation === 
     63Currently we maintain both an html and a PDF copy of the documentation available on the !SasView website. Make sure to follow '''BOTH''' steps below. 
     64 
     65==== HTML version ==== 
     66 * The documentation folder contents (html version) needs to be moved to the docs repo. 
     67   * '''NOTE:''' this is '''no longer''' in the sasview.github.io website repository. It is in its own separate repository called docs 
     68  * The first step it to git create a new folder (docs_x.y.z) under `docs/old_docs` where x.y.z is the version number being superseded (i.e. the version of the docs currently in the repo). 
     69  * Git move all the folders and files currently under docs to `old_docs/docs_x.y.z` 
     70  * Git copy the new html docs (all folders and files) to the docs repository 
     71    * '''NOTE:''' While the docs could be built locally, for consistency with the release docs it is strongly recommended that the release version be installed locally and the docs copied from the install path. These can just be git copied into the docs repo folder. 
     72  * Commit and push these changes 
     73==== PDF Version ==== 
     74 * The documentation is also built as a PDF and the PDF link for the website also needs to be updated to the new PDF version. 
     75   * '''NOTE:''' the downloads folder containing the PDF is '''still''' in the sasview.github.io website repository 
     76   * Again, the first step is to git move the !SasViewDocumentation.pdf to downloads/Old_SasViewDoucmentation/ 
     77    * '''NOTE:''' It should be renamed to SasViewDocumentation_X.y.z.pdf where X.y.z is the version number for that documentation file 
     78   * The new PDF is available on the Jenkins Master Build tab of the OSX and Ubuntu builds only. **NOTE:** they are **not** currently available in any of the release builds which means they should be downloaded from Master build immediately after last commits before tagging a release.  This should be changed to add a PDF build on the release servers at some point. 
     79   * PDF should be downloaded as !SasViewDocumentation.pdf. 
     80   * The pdf should then be git copied or git moved to the sasview.github.io/downloads folder. 
     81   * Commit and push changes 
    7582 
    7683== Uploading sasmodels to pypi ==