SysML
"Die Systems Modeling Language (OMG SysML) ist eine grafische, auf UML 2 basierende, standardisierte Modellierungssprache. Ihre Anwendung findet sie im Bereich Systems Engineering für die Modellierung verschiedener komplexer Systeme. Die Menge der in SysML definierten Diagramme besteht aus einer Untermenge von Diagrammen, die sich aus in UML 2 definierten Diagrammen ableiten lassen, ergänzt durch SysML-spezifische Diagramme. Es werden Struktur- und Verhaltensdiagramme unterschieden (siehe Grafik). Dem Anforderungsdiagramm als SysML-spezifischem Diagrammtyp kommt eine Einzelrolle zu." [1]
Dictionary
Common
Note
"A note can be attached to comment and represent its information in more details. We advice to use Note when you want to display annotated element documentation, properties (e.g. hyperlink) on simply comment on diagram (e.g. note to yourself to clarify some details for specific element later), but you do not need this information in report and you do not need this information in other diagram. If you want to include the annotating information into report, annotate element not in browser, or reuse the information in other diagram (for example, if it is some note for all modelers working with specific element), you need to use Comment." https://community.nomagic.com/comment-vs-note-t3014.html
Comment
"A comment is a textual annotation that can be attached to a set of Elements. It is an UML element defined in UML specification, can exist without diagram and be created directly from model browser. One comment can be reused in several diagrams. It can be found in the model using Search even if it is not placed in diagram. As comments are elements, their text can be used in reports.=== A note is a graphical symbol containing textual information. It is not an element. It is used to add any explanatory information needed for your element or diagram, or if user needs to display element properties not displayed on element shape. A note is usually connected to the element symbol using an anchor line." https://community.nomagic.com/comment-vs-note-t3014.html
Problem
The SysML Problem and Rationale extensions of the Comment are useful and pretty self-explanatory. But they are also a bit limited because they don't have any Stereotype properties for carrying "tagged values" metadata.=== So next we'll see how we can easily extend Comment ourselves to create a custom stereotype that can carry a bit more structured information.