Issues with reslang `diagram`

[j-q-arnold]

Working with reslang diagram from diagrams.md.

• The models/file command does not work. Should be

  ./reslang models/file --diagram main --open

• Would be helpful for the extended example to use models/file instead of switching to DestinationAccount and related resources from some other project. Or give the repo with the source for the extended example.
• I find the includeAll syntax confusing. The example uses files.reslang, which looks like a source file reference, but the repo does not have a file by that name. Unclear what files means and unclear what the .reslang suffix means. Suggest some other syntax that removes the confusion with path names.
• Also on the includeAll, the actual models/file/diagrams.reslang includes a line all in the /include section. Please give details for the lines in the /include and /includeAll sections.
• /exclude. Seems to work on individual resources, but would be helpful to exclude an entire resource tree (and associated actions). I have a top-level resource with subresources and actions. I excluded the top level resource in one diagram, but the subresources and the actions were still included. Maybe Name.* or Name::*? Maybe even /excludeAll and include individual resources (?).
• Scale issues. With a resource tree of any size, the diagram scales (in SVG) and is too small to read. Unclear exactly how to deal with this, but I'm trying to divide the reslang into multiple diagrams. The /exclude limitations make that tedious.

[liveandrew]

i don't think any of the above are an issue in practice. the diagram syntax allows you to specify which files are included, it solves the scale issue - you can either exclude or include files. are you dealing with so many files this is too much to handle?