Skip to content

Add a BPMN 2.0 cheat sheet with an accessible web guide and PDF - #109

Merged
transitrix merged 1 commit into
mainfrom
codex/bpmn-cheat-sheet
Oct 21, 2026
Merged

transitrix merged 1 commit into
mainfrom
codex/bpmn-cheat-sheet

Conversation

@transitrix

Copy link
Copy Markdown
Owner

Adds a library page and one-page PDF for reading common BPMN process and collaboration diagrams. Covers events, activities, gateways, flows, pools/lanes and boundary events with 24 inline vector illustrations, text labels and short explanations. Both formats identify OMG BPMN 2.0.2 (formal/2013-12-09) as their source and explicitly limit coverage to selected reading symbols.

Distinguishes catching/throwing message markers, interrupting/non-interrupting boundary rings, exclusive/inclusive/parallel/event-based gateways, flow line styles and parallel/sequential multi-instance markers. The latter follows Clause 10.3.8 and Figures 10.48-10.49. The page links the normative OMG specification; the PDF links only to its transitrix.com page.

Adds the library card, exact manifest entries, checksum and generated sitemap. The 297 × 167 mm PDF embeds IBM Plex fonts. Production source, renderer and checker remain outside this repository.

Validation: source clauses and figures inspected; PDF rendered and visually checked as one page (841.92 × 473.04 pt). Private checks verify PDF geometry/content/links and selected SVG semantics, refusing Letter, multiple pages, third-party links, swapped multi-instance markers and solid non-interrupting boundary rings. Both existing PDF validators, 18 artifact tests, manifest and 67-file consumer build/archive pass. Local library-to-page/PDF clicks and 390px mobile checked without horizontal overflow. Content acceptance, independent review, merge and separately authorized publication remain pending.

@vkgeorgia vkgeorgia left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fresh agent review of exact head d27c8c7 against 96d4dec: no actionable findings. Reviewed all six changed files and the rendered PDF against the formal OMG source. Independently parsed the actual reader HTML's 24 vector illustrations: event ring differences, catch/throw fill, both multi-instance orientations, event-based gateway double circle, message-flow endpoints/line style and boundary ring styles agree with the source-defined meanings. Labels, selection limits, empty End Event wording, attribution, page/PDF route, manifest/checksum and sitemap are consistent. Production files remain outside the public repository.

Repeat verification: 18 artifact tests, both PDF validators, production refusal probes, manifest and 67-file consumer build/archive pass. PDF is one page with embedded IBM Plex fonts and only its owned-domain reference link; both OMG links return HTTP 200. Exact-head CI: 12 SUCCESS and expected Dependabot auto-merge SKIPPED, no pending/failures. Manual-only deployment workflow is unchanged. Publication/live acceptance remains separate and was not initiated.

@transitrix
transitrix marked this pull request as ready for review October 21, 2026 17:30
@transitrix
transitrix merged commit fbe765d into main Oct 21, 2026
13 checks passed
@transitrix
transitrix deleted the codex/bpmn-cheat-sheet branch October 21, 2026 17:31
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.

2 participants