Refreshed the developer guide’s front matter

Refreshed the developer guide’s front matter with a formal title, up-to-date metadata, and manual TOC placement, then regrouped chapters into thematic parts while isolating legacy-only topics in a dedicated “Historical Reference” section.

Added a release-only step to the documentation workflow that stamps the guide with the current publication date and Codename One version before building artifacts.

Author: shai-almog

.github/workflows/developer-guide-docs.yml

@@ -21,6 +21,24 @@ jobs:
       - name: Check out repository
         uses: actions/checkout@v4
 
+      - name: Update publication metadata for release
+        if: ${{ github.event_name == 'release' && github.event.action == 'published' }}
+        env:
+          RELEASE_TAG: ${{ github.event.release.tag_name }}
+        run: |
+          set -euo pipefail
+          REV_DATE="$(date -u +%Y-%m-%d)"
+          VERSION="${RELEASE_TAG:-}"
+          if [ -z "$VERSION" ] && [ -n "${GITHUB_REF_NAME:-}" ]; then
+            VERSION="$GITHUB_REF_NAME"
+          fi
+          VERSION="${VERSION#v}"
+          if [ -z "$VERSION" ]; then
+            VERSION="UNKNOWN"
+          fi
+          sed -i -E "s/^:revdate: .*/:revdate: ${REV_DATE}/" docs/developer-guide/developer-guide.asciidoc
+          sed -i -E "s/^:revnumber: .*/:revnumber: ${VERSION}/" docs/developer-guide/developer-guide.asciidoc
+
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:

docs/developer-guide/developer-guide.asciidoc

@@ -18,18 +18,27 @@
 :uuid: 92CA37B2-EB2B-4B8F-AC7C-1ED13683F7FB
 :front-cover-image: image:img/cover.png[Front Cover,1000,1600]
 :lang: en-US
-//:revdate: 2018-07-22
+:revdate: 2025-10-20
+:revnumber: DEV-SNAPSHOT
 :doctitle: Codename One Developer Guide
-:author: Shai Almog, Steve Hannah and Chen Fishbein
-:producer: Codename One Academy
+:author: Codename One Documentation Team; Shai Almog; Steve Hannah; Chen Fishbein
 :description: Build native mobile apps in Java
 :keywords: java, android, ios, iphone, mobile development
 :copyright: Codename One, all rights reserved
 :publication-type: book
+:producer: Codename One Ltd.
+:partnums:
+
+= {doctitle}
+{author}
+
+toc::[]
 
 include::About-This-Guide.asciidoc[]
 
-include::index.asciidoc[]
+= Part I. Foundations
+
+include::Index.asciidoc[]
 
 include::basics.asciidoc[]
 
@@ -39,16 +48,18 @@ include::Advanced-Theming.asciidoc[]
 
 include::css.asciidoc[]
 
+= Part II. User Interface and Experience
+
 include::The-Components-Of-Codename-One.asciidoc[]
 
 include::Animations.asciidoc[]
 
 include::The-EDT---Event-Dispatch-Thread.asciidoc[]
 
-include::Monetization.asciidoc[]
-
 include::graphics.asciidoc[]
 
+= Part III. Application Services
+
 include::Events.asciidoc[]
 
 include::io.asciidoc[]
@@ -59,20 +70,28 @@ include::Miscellaneous-Features.asciidoc[]
 
 include::performance.asciidoc[]
 
+include::Monetization.asciidoc[]
+
+= Part IV. Platform and Deployment
+
 include::Advanced-Topics-Under-The-Hood.asciidoc[]
 
+include::security.asciidoc[]
+
 include::signing.asciidoc[]
 
 include::Working-With-iOS.asciidoc[]
 
 include::Working-With-Javascript.asciidoc[]
 
-include::Working-with-UWP.asciidoc[]
-
 include::Working-with-Mac-OS-X.asciidoc[]
 
-include::security.asciidoc[]
-
-include::Travis-CI-Integration.asciidoc[]
+= Part V. Contributing and Appendices
 
 include::Working-With-CodenameOne-Sources.asciidoc[]
+
+= Historical Reference
+
+include::Working-with-UWP.asciidoc[]
+
+include::Travis-CI-Integration.asciidoc[]