Skip to content

docs: route cn1lib creation through the Maven cn1lib-archetype#4952

Merged
shai-almog merged 1 commit into
masterfrom
docs/maven-cn1lib-guide
May 15, 2026
Merged

docs: route cn1lib creation through the Maven cn1lib-archetype#4952
shai-almog merged 1 commit into
masterfrom
docs/maven-cn1lib-guide

Conversation

@shai-almog
Copy link
Copy Markdown
Collaborator

Summary

  • The "Libraries - cn1lib" chapter in the developer guide still walked readers through the legacy NetBeans/Eclipse plugin wizard ("Select the CodenameOne Library Option" screenshots) and Ant Refresh cn1lib files flow. Re-route these sections to the Maven cn1lib-archetype + pom-dependency workflow that already exists in Maven-Creating-CN1Libs.adoc (anchor creating-cn1libs).
  • Updates "How to use cn1libs", "Creating a simple cn1lib", "Build hints in cn1libs" intro, "Part 3: Packaging as a cn1lib", and the Kotlin/JVM-language port narrative. Legacy Ant instructions are preserved as clearly-labelled sidebars/notes so existing Ant users aren't left stranded.
  • Deletes the two orphaned wizard screenshots (cn1lib-create-step1.png, cn1lib-create-step2.png) that were no longer referenced.

Test plan

  • Rebuild the developer guide PDF/HTML and confirm the cn1lib chapter renders the new Maven examples and cross-references resolve to creating-cn1libs / maven-project-workflow.
  • Spot-check that no remaining image::img/cn1lib-create-step*.png[] references exist anywhere in the repo.

🤖 Generated with Claude Code

Advanced-Topics-Under-The-Hood still walked readers through the old
NetBeans/Eclipse plugin wizard ("Select the CodenameOne Library Option"
screenshots) and the Ant `Refresh cn1lib files` flow for installing
libraries. New projects use Maven, and the canonical library-creation
guide already lives in Maven-Creating-CN1Libs.adoc — so this section
now leads with the `cn1lib-archetype` + pom-dependency workflow and
keeps the Ant instructions only as a clearly-labelled legacy sidebar.

Also removes the orphaned cn1lib-create-step{1,2}.png screenshots that
were tied to the old wizard.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@github-actions
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: Vale failed (exit code 2) (report)
  • Image references: 2 unused image(s) found (report)

Unused image preview:

  • img/cn1libs-refresh.png
  • img/skin-designer/.gitkeep

@github-actions
Copy link
Copy Markdown
Contributor

Cloudflare Preview

@shai-almog shai-almog merged commit f6486b1 into master May 15, 2026
8 checks passed
shai-almog added a commit that referenced this pull request May 16, 2026
Splits the find_unused_images.py check into a real quality gate:
- ignore non-image files in the image tree so .gitkeep placeholders
  no longer flash as orphans
- exit non-zero when at least one unused image is found so the new
  quality-gate step at the end of the developer-guide workflow can
  fail the build with the other linters

Also removes docs/developer-guide/img/cn1libs-refresh.png, which was
orphaned by #4952 when the matching image:: directive was deleted
alongside the other cn1lib screenshots.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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