Ambiguous Instructions in "Model Your First System"

[MathesiusSuperbus]

Hi all!
I am trying to follow the Model Your First System tutorial and I am finding the instruction points 8 to 11 in the second part of Step 3: Flashlight Requirements Tree quite ambiguous.

8. Edit the new attribute to actualweight :> mass
   • Perhaps say that I should edit the name or the declared name?
9. Right-click on the background of diagram and use the tool New Namespace Import. Then select SI/Library Package SI to import it from the standard libraries.
   • Suggest stating that the New Namespace Import is in the Structure menu
   • the imported library is not shown on the diagram in the tutorial. Not clear why it is imported
10. Use the palette filter to locate the New Required Constraint tool, and apply it to the weight requirement.
11. Edit the constraint to: actualweight<=0.25[kg]
    • Again - is it meant so that I should edit the name of the constraint?

Also the weight requirement in the diagram shown below the instructions has the attribute set to "actualweight :> ISQBase::mass" which is different from what point 8 asks for. Is this an inconsistency or is this done by using the imported library in some way that is not described in the instructions?

Thanks in advance for any feedback!

[AxelRICHARD]

Hello,

Thank you for using SysON and for your remarks!

My answers below:

8. Edit the new attribute to actualweight :> mass  
   * Perhaps say that I should edit the name or the declared name?

"actualweight :> mass " will set both the declaredName (actualweight) and the type (mass) of the new attribute.
I will update to make it more clear.

9. Right-click on the background of diagram and use the tool New Namespace Import. Then select SI/Library Package SI to import it from the standard libraries. 
   * Suggest stating that the New Namespace Import is in the Structure menu
   * the imported library is not shown on the diagram in the tutorial. Not clear why it is imported

We need to import the SI library to be able to use kg as a unit.
In a future release, this should be fixed and will not be needed anymore, this will be done automatically when kg will be set as the unit of 0.25[kg].
I will update the documentation on both points.

11. Edit the constraint to: actualweight<=0.25[kg]
    * Again - is it meant so that I should edit the name of the constraint?

No, it is the condition/predicate of constraint. In SysMLv2, a ConstraintUsage is also a BooleanExpression. The "11. Edit the constraint" is about that.
I will update to make it more clear.

Also the weight requirement in the diagram shown below the instructions has the attribute set to "actualweight :> ISQBase::mass" which is different from what point 8 asks for. Is this an inconsistency or is this done by using the imported library in some way that is not described in the instructions?

"ISQBase::mass" is the qualified name of "mass".
By default, we display the qualified name of types.
This will change in the future, we will try to only display the declaredName "mass" instead of the qualified name "ISQBase::mass" if there is an import of the appropriate library (ISQBase here).

Regards,