Best practice for releasing a new version.

CHANGELOG.md

@@ -36,14 +36,84 @@ Features
 Bug Fixes
 ^^^^^^^^^
 
-Version 0.23.0
+Version 0.25.1
 --------------
 
-Date: 17.09.2017
+Date: 3.11.17
+
+Bug Fixes
+^^^^^^^^^
+
+* #4857 - broken (stale) download: multiple 'u:..' or 'u:...'
+* #4212 - Broken JSON on response to save new record 'Unknown index' fixed by isset()
+
+Version 0.25.0
+--------------
+
+Date: 10.10.2017
 
 Notes
 ^^^^^
 
+* The config.qfq.ini directives DB_USER, DB_NAME, DB_HOST, DB_PASSWORD are replaced by DB_1_USER, DB_1_NAME, DB_1_HOST,
+  DB_1_PASSWORD. The old directives are still used, as long as the new directives does not exist.
+
+* New config.qfq.ini directives: DB_INDEX_DATA, DB_INDEX_QFQ
+
+Features
+^^^^^^^^
+* #4720 - Separate database handles for QFQ 'form' and QFQ 'data' - 'Form' might  now load/save from forign database/host/user.
+
+
+Version 0.24.0
+--------------
+
+Date: 09.10.2017
+
+Notes
+^^^^^
+
+* Change Remove SYSTEM_SECURITY_ABSOLUTE_GET_MAX_LENGTH - makes no sense to hardcode an upper limit.
+
+Features
+^^^^^^^^
+
+* Feature Manual.rst: Doc updated for latest subrecord column special names
+* Feature AbstractBuildForm.php: new function subrecordHead(). Replaced several hard coded subrecord column names against constants.
+* Feature #4456 / formModeGlobal=requiredOff - update Manual.rst
+* Feature #4606 / _link: qualifier to render bootstrap button - fix unit tests for tooltip. Add tooltip to button/text, even if there is no link. Implement token  'b:...' for link class. Manual is updated. Open: `pageX` should be recoded to use the new 'b:' instead of hardcoed behaviour to render a button.
+* Feature: Upload Button - wrapped with Bootstrap Button. New option 'fileButtonText' to specify a button text.
+* Feature #3752 / Pills auf mode|modeSql=hidden|readonly setzen - implemented during 'form load' (not dynamic update)
+* Feature: Neu wird nach dem Speichern das Formular nochmal komplett geladen. Das ist wichtig um die durch aftersave geaenderten Records in die Formularelemente zu bekommen.
+* Feature #4511 / Form: URL Forward - mode dynamic computed - more generic implementation.
+
+Bug Fixes
+^^^^^^^^^
+
+* Bug #4731 / Dynamic Update: load(post) triggers 'check required' - makes no sense during filling a form - fixed
+* Bug #4730 / InvalidDate-00-00-2000 FE.type=date - detection of empty date was broken for '00.00.0000'.
+* Bug Fixed problem in subrecord when no record is selected.
+* Bug #4620 / Easy Fix: saveButtonText / closeButtonText Formatierung
+
+Release
+=======
+
+Version 0.23.1
+--------------
+
+Date: 23.9.2017
+
+Bug Fixes
+^^^^^^^^^
+
+* #4620 / Easy Fix: saveButtonText / closeButtonText Formatierung
+
+
+Version 0.23.0
+--------------
+
+Date: 17.09.2017
+
 Features
 ^^^^^^^^
 

Makefile

@@ -139,3 +139,8 @@ sonar: .sonar_scanner
 
 
 .PHONY: nightly maintainer-clean snapshot release git-revision t3sphinx build-dist make-dist-dir dist-move-doc dist-copy-extension pip-temp-directory plantuml sonar
+
+copyReleasNotes:
+	cp extension/Documentation/Release.rst extension/RELEASE.txt
+	cp extension/Documentation/Release.rst CHANGELOG.md
+

doc/NewVersion.md

@@ -9,44 +9,49 @@ Neuer Build
 Neue Versionsnummer
 ===================
 
-1) Laufen die Unit Tests durch?
+1) **Laufen** die Unit Tests durch?
 
 2) Die aktuellen Commits anschauen und wichtige Topics uebernehmen (git log > ~/qfq.log, alles bis zum letzten TAG anschauen):
 
    # complicated:  git log | grep -v -e '^commit ' -e  '^Author: ' -e '^Date: ' -e '^Merge: ' > /tmp/out; pluma  /tmp/out
    
-   # Zeigt alle Commits an, die seit dem aendern von NewVersion gemacht wurden! Das sollten alle Commits seit der letzten Version sein.
+   # Zeigt **alle Commits** an, die seit dem aendern von NewVersion gemacht wurden! Das sollten alle Commits seit der letzten Version sein.
    * git log --pretty=%s --after="`stat -c %y doc/NewVersion.md`"
 
-   * qfq/extension/Documentation/Release.rst  
-   * Den Inhalt von Release.rst kopieren nach qfq/extension/RELEASE.txt.
-   * Den Inhalt von Release.rst kopieren nach CHANGELOG.md.
+   * **Anpassen**: qfq/extension/Documentation/Release.rst
+     
+   * Release.rst **verteilen**:  make copyReleasNotes
+   
+   * Manuell:
+    
+     * Den Inhalt von Release.rst kopieren nach qfq/extension/RELEASE.txt.
+     * Den Inhalt von Release.rst kopieren nach CHANGELOG.md.
 
 3) In folgenden Files anpassen:
 
-   Auto: ./setVersion.sh <MAJOR>.<MINOR>.<MICRO>
+   **Auto**: ./setVersion.sh <MAJOR>.<MINOR>.<MICRO>
    
    Manuell:
      * extension/Documentation/_make/conf.py: release, version
      * extension/Documentation/Settings.cfg: version
      * extension/ext_emconf.php: version
 
-4) Im Projektverzeichnis:
+4) Im Projektverzeichnis: **Doc**
 
    make t3sphinx   (dadurch fallen Fehler in der RESTdoc Syntax auf)
 
-5) Commit
+5) **Commit**
    * Update the version number in this document (topic 6)
    * Commit & Push new version changes to master branch: 
    
       New version x.y.z.
 
-6) New Tag: 
+6) **New Tag**: 
 
    git tag v0.25.1
    git push -u origin v0.25.1
 
-7) PhpStorm: Sync all files to VM qfq.
+7) PhpStorm: **Sync** all files to VM qfq.
 
 
 Update Doku auf docs.typo3.org
@@ -54,9 +59,10 @@ Update Doku auf docs.typo3.org
 
 https://docs.typo3.org/typo3cms/drafts/github/T3DocumentationStarter/Public-Info-053/
 
-1) Im `qfq` Projektverzeichnis: make update-qfq-doc
-2) In `qfq-doc` Projektverzeichnis wechseln und auf github einchecken:
+1) Copy - Im `qfq` Projektverzeichnis: make update-qfq-doc
+2) Commit - In `qfq-doc` Projektverzeichnis wechseln und auf github einchecken:
+
    git commit -a
    git push        # User: math-uzh, PW: <kpit>
 
-one line:  make update-qfq-doc; pushd ../qfq-doc; git commit -a; git push; popd
\ No newline at end of file
+**one line**:  make update-qfq-doc; pushd ../qfq-doc; git commit -a; git push; popd
\ No newline at end of file