Skip to content

[plantuml tooling] add guideline on element identifiers - #479

Merged
LittleHuba merged 1 commit into
mainfrom
joho_add_element_identifier
Sep 22, 2026
Merged

LittleHuba merged 1 commit into
mainfrom
joho_add_element_identifier

Conversation

@hoe-jo

@hoe-jo hoe-jo commented Sep 21, 2026

Copy link
Copy Markdown
Contributor

No description provided.

@hoe-jo
hoe-jo force-pushed the joho_add_element_identifier branch from b5f2698 to 7846c7f Compare September 21, 2026 13:25
Comment on lines +341 to +344
- **Component relation endpoints prefer the surrounding scope.** Inside
`package pkg`, an endpoint written as `a.B` binds to `pkg.a.B` when such an
element exists, and only otherwise to the root-anchored reading. Class
references do not have this ambiguity.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Mention that this means the bazel package.

@hoe-jo hoe-jo Sep 22, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

removed, its actually a bug, will be a follow up PR

Comment on lines +345 to +347
- **Cross-diagram hyperlinks (`idmap`) are not yet identifier-based for
sequence diagrams**, so clickable links from a sequence participant to its
component may not resolve.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Also applies for class diagrams

Comment on lines +366 to +374
### Rule 0

**Parser/resolver split.** The parser never derives an identifier. It records
only alias, display name, and the enclosing scope as written. All identifier
construction happens in the resolver. The resulting field is
`LogicComponent.id` for components, `SimpleEntity.id` for classes, and
`SequenceParticipant.uid` for sequence participants.

### Rule A

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Number or letter, but please no mix.

@hoe-jo
hoe-jo force-pushed the joho_add_element_identifier branch from 7846c7f to a39246d Compare September 22, 2026 06:37
@hoe-jo
hoe-jo requested a review from LittleHuba September 22, 2026 06:41
@LittleHuba
LittleHuba merged commit c8e61f3 into main Sep 22, 2026
15 checks passed
@LittleHuba
LittleHuba deleted the joho_add_element_identifier branch September 22, 2026 10:50
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