Update CHANGELOG and RELEASE NOTES

Add details on new features.
See issue #52
See also #53 #54 #55

This work was performed for NASA GRC-ATF by WikiWorks per NASA Contract NNC15BA02B.

CHANGELOG

@@ -1,3 +1,78 @@
+commit 86aea143c9546af22a3108cb6660658391915c93
+Author: Greg Rundlett <[email protected]>
+Commit: Greg Rundlett <[email protected]>
+
+    Fix first-time deploy errors related to SMW rebuild data
+
+    Add the special 'never' tag to the task in the MediaWiki role.
+    With the 'never' tag, this task will ONLY be run if you specifically ask
+    for it with the --tags=smw-data option (or --tags=never option).
+
+    This changes behavior of Meza so that it does not rebuild SMW data
+    on each and every deploy. To specifically request a SMW rebuild, simply
+    ask for it by name with `sudo meza deploy monolith --tags smw-data`
+
+    Fixes Issue #80
+
+    This work was performed for NASA GRC-ATF by WikiWorks per NASA Contract NNC15BA02B.
+
+commit 74e74a201cdaeca7b6e3eff1091ca8482f112c64
+Author: Greg Rundlett <[email protected]>
+Commit: Greg Rundlett <[email protected]>
+
+    Change SAML logging handler to file
+
+    simpleSAMLphp's logging handler is 'syslog' by default.
+    Change the handler to 'file' so that we can see the logs in the logging directory.
+
+    See Issue #74
+
+    This work was performed for NASA GRC-ATF by WikiWorks per NASA Contract NNC15BA02B.
+
+commit 0ac901cf173175fbed162dafc51ac6b598d2f748
+Author: Greg Rundlett <[email protected]>
+Commit: Greg Rundlett <[email protected]>
+
+    Update saml20-idp-remote.php
+
+    Fix syntax:
+    - update array syntax for PHP8
+    - avoid double open array by putting it after the conditionals
+    - vertical spacing
+    - indentation
+    - output an 'error message' in a PHP comment when cert data is not defined
+
+    Move 'FIXME' into a jinja comment so it is not templated out
+
+    See #74
+
+    This work was performed for NASA GRC-ATF by WikiWorks per NASA Contract NNC15BA02B.
+
+commit c8f3317fa28d2a0d2f6559fe8872cd58d6f8d387
+Author: Greg Rundlett <[email protected]>
+Commit: Greg Rundlett <[email protected]>
+
+    Add commit template; Add Rich to Release Notes
+
+    Use the commit template by issuing a git config command
+    git config commit.template ./.git-commit-template
+
+    Add Rich Evans to Release Notes 'contributors' section
+
+    See Issue #54
+
+    This work was performed for NASA GRC-ATF by WikiWorks per NASA Contract NNC15BA02B.
+
+commit 5e2200b7fbff0e3e5749502b32fd024a7ea1ccb4
+Author: Greg Rundlett <[email protected]>
+Commit: Greg Rundlett <[email protected]>
+
+    Create Release Notes for v39.5.0
+
+    Updated CHANGELOG and RELEASE-NOTES.md for the v39.5.0 release.
+    Fixes #55
+    See also #52 #53 #54
+
 commit dce594e272571092ee1f00c444f96b0500ea3c45
 Author: Greg Rundlett <[email protected]>
 Commit: Greg Rundlett <[email protected]>
@@ -1107,31 +1182,3 @@ Commit: Greg Rundlett <[email protected]>
     remove legacy_load directive; improve configuration
 
     This work  was performed for NASA GRC-ATF by WikiWorks per NASA Contract  NNC15BA02B.
-
-commit 876b8ac9d13f48fcc229aab01ec866bcaec98f68
-Author: Greg Rundlett <[email protected]>
-Commit: Greg Rundlett <[email protected]>
-
-    Major upgrade of Meza for MediaWiki 1.39
-
-    Upgrade default version of MediaWiki to REL1_39
-
-    This work  was performed for NASA GRC-ATF by WikiWorks per NASA Contract
-    NNC15BA02B.
-
-commit f8efb6fc23fd305850490501bdaf769b41e90de1
-Author: James Montalvo <[email protected]>
-Commit: Greg Rundlett <[email protected]>
-
-    fix: load balancer variable naming
-
-    Commit 45c7cb04 changed how load balancer groups are accessed. This was
-    a good change, but some of the load balancer variables were changed
-    accidentally. e.g.
-
-    load_balancers_nonmeza --> load_balancers_meza_nonmeza
-
-    This "_meza_nonmeza" ending (a) was applied inconsistently and (b)
-    doesn't make sense as a naming convention.
-
-    This commit fixes naming.

RELEASE-NOTES.md

@@ -11,7 +11,7 @@ Upgrades:
   - SimpleSAMLphp library to 2.2.1
   - Extension Pluggable Auth 7.0
   - Extension SimpleSAMLphp 7.0
-- Composer (respect `composer_keep_updated`)
+- Composer
 - Extensions
   - Simple Batch Upload
   - Flow
@@ -37,28 +37,61 @@ The following extensions were removed due to incompatibility
 - Talk Right
 - Wiretap
 
-New Features: 
-- Pretty URLs (no index.php in the URL, just mysite.com/wiki/SomePage)
-- Add `overwrite_local_git_changes` option (default: off) for deploys
-- .webp images supported for upload
+New Features:
+- Only execute SMW Rebuild Data when requested explicitly. 
+  This feature improves the separation of concerns between "platform updates"
+  and "special maintenance". It is accomplished using the tags feature
+  of Ansible: `meza deploy monolith --tags smw-data` 
+
+  Note that you can use the `meza maint rebuild` command to rebuild 
+  SMW data **and** Elasticsearch indexes. This command is equivalent to 
+  `meza deploy monolith --tags smw-data,search-index`
+
+- Pretty URLs 
+  There is no *index.php* in URLs, just `mysite.com/wiki/SomePage`
+  Easier to type, easier to read, easier to remember, shorter, and pretty!
+
+- Deploy over local changes
+  Added `overwrite_local_git_changes` option (default: off) for deploys. Say you
+  check out some new branch of code in a particular extension or MediaWiki itself.
+  Then you test that in the browser and get results (good or bad). Next you want to
+  re-deploy to a known state. This option allows you more control with less work.
+  The default value is 'false' (off) preserving current behavior which will fail
+  the deploy, refusing to overwrite local changes.
+
+- WebP (.webp) images are supported for upload
+  The WebP format now makes up 12% of the web. Designed to be more efficient than
+  JPEG and PNG images, the WebP format uses advanced compression for smaller size
+  without losing quality. WebP is supported by 96.3% of browsers.
+  https://en.wikipedia.org/wiki/WebP
+
+- Keep composer updated
+  The configuration option `composer_keep_updated` is observed when running a
+  deploy. Thus, if this role variable is set to 'true' (default), `composer` will
+  self-update on your targets providing you with the latest features, bugfixes
+  and security patches to composer itself.
 
 Other Changes:
-- Reduce git clone size of MediaWiki / improve speed
+- Reduce git clone size of MediaWiki by 2+GB / improve speed
 - Add .editorconfig
 - Version lock Ansible and Python
-- Disable (automatic) Elasticsearch upgrades
-- Set PHP-FPM default port to 9000
+- Disable (automatic) Elasticsearch upgrades for predictability
+- Set PHP-FPM default port to 9000 avoiding surprises or conflicts
 - Syntax cleanup
 - Bug fixes in Python, PHP, YAML
-- Documentation of meza.py
+- Documentation of all 50+ meza.py functions
 - Improve testing scripts
 - Create CHANGELOG
 - Remove obsolete $wgShellLocale
 - Allow easier forking
 - Enable Ansible debugger
 
 ### Commits since 35.x
-
+* 86aea14 (HEAD -> REL1_39, tag: 39.6.0, freephile/REL1_39) Fix first-time deploy errors related to SMW rebuild data
+* 74e74a2 Change SAML logging handler to file
+* 0ac901c Update saml20-idp-remote.php
+* c8f3317 Add commit template; Add Rich to Release Notes
+* 5e2200b (tag: 39.5.0) Create Release Notes for v39.5.0
 * dce594e (HEAD -> REL1_39, origin/REL1_39) Versionlock Ansible and Python to prevent incompatibilities
 * 84e08b0 Fix deploy errors on initial deploy
 * 58933f2 Fix fatal recursion errors
@@ -157,8 +190,8 @@ Other Changes:
 * 876b8ac Major upgrade of Meza for MediaWiki 1.39
 
 ### Contributors
-* 89 Greg Rundlett
-* 8 Rich Evans
+* 94 Greg Rundlett
+* 7 Rich Evans
 
 # How to upgrade
 There is no automatic upgrade path yet from 35.x to 39.x due to the major