Skip to content

Extract developer guide snippets into demos#5340

Merged
shai-almog merged 2 commits into
masterfrom
codex/developer-guide-demo-extraction
Jul 6, 2026
Merged

Extract developer guide snippets into demos#5340
shai-almog merged 2 commits into
masterfrom
codex/developer-guide-demo-extraction

Conversation

@shai-almog

@shai-almog shai-almog commented Jul 6, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • update the developer guide demos project to Java 17 and Codename One 8.0-SNAPSHOT
  • move guide source blocks into demo-backed include files so Java/CSS/native/platform snippets are validated from real files
  • compile generated Java snippets and Codename One CSS through the docs/demos build
  • add validation for include tags, Android demo sources, and unused guide images

Scope

  • Guide images under docs/developer-guide/img are intentionally untouched.
  • No screenshot baselines are committed in this PR.
  • The workflow does not compare or commit generated screenshots; screenshot refreshes should be handled in later chapter-specific PRs, with generated images discarded or uploaded as artifacts.

Local validation

  • python3 scripts/developer-guide/validate-guide-snippets.py
  • scripts/developer-guide/compile-android-demo-sources.sh
  • mvn -B -ntp -Dgenerate-gui-sources-done=true -Dcodename1.platform=javase -f docs/demos/pom.xml process-classes
  • python3 scripts/developer-guide/find_unused_images.py docs/developer-guide --allow-unused img/autocomplete.png --allow-unused img/native-theme-menu.png --allow-unused img/tabs.png
  • git diff --check

@shai-almog shai-almog force-pushed the codex/developer-guide-demo-extraction branch from d6ed1de to e169454 Compare July 6, 2026 12:51
@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Cloudflare Preview

@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Developer Guide build artifacts are available for download from this workflow run:

Developer Guide quality checks:

  • AsciiDoc linter: No issues found (report)
  • Vale: No alerts found (report)
  • Paragraph capitalization: No paragraph capitalization issues (report)
  • LanguageTool: No grammar matches (report)
  • Image references: No unused images detected (report)

@shai-almog shai-almog force-pushed the codex/developer-guide-demo-extraction branch from e169454 to 9559058 Compare July 6, 2026 13:03
@shai-almog shai-almog force-pushed the codex/developer-guide-demo-extraction branch from 9559058 to 2434082 Compare July 6, 2026 13:28
@shai-almog shai-almog changed the title Extract developer guide snippets into demos Modernize developer guide demos build Jul 6, 2026
@shai-almog shai-almog changed the title Modernize developer guide demos build Extract developer guide snippets into demos Jul 6, 2026
@shai-almog shai-almog merged commit bbdc605 into master Jul 6, 2026
14 checks passed
@shai-almog shai-almog deleted the codex/developer-guide-demo-extraction branch July 6, 2026 18:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant