lizzcondrey
commented
2 days ago Hey, @cybermerlin, thank you for reaching out with your commentary and request. So, from this, one of the things we need to do a better job of is referencing our additional plugins from the core tool and not just from the plugins to the core tool.
So, the core tool (meaning just the aac package), lets you textually represent a system as a human readable model in a YAML definition file. From that model definition you can do some basic generation and analysis with the core tool. Then, with our currently developed plugins you can generate additional representations and outputs.
We have a Plant UML plugin, aac-puml, that will take your model file and utilize various portions to generate component, sequence, object, and requirements diagram textual representations that can be paired with a PUML interpreter to generate "boxes and lines" diagrams. We utilize a PUML extension within VSCode for this and it is provided within the GitPod container image for our PUML plugin.
We have a Gherkin plugin, aac-gen-gherkin, that will take your model file and utilize the behavior portion to generate a Gherkin Feature file that can be used to help build up a test automation capability for evaluating your system design.
Hopefully this helps answer some of your questions about what could AaC be used for with your work. Feel free to reach out with additional questions and we'll start with some documentation clean-up to better connect the core tool and the supporting plugins as a start.
Documentation Types
Requested Documentation
Hello. I am starting to develop a system for architects to build diagrams from existing infrastructure, make it easy to manage ADR collection, and draw diagrams of data models, infrastructure and describe processes, and then convert all this into code and monitor the performance of the work done. There is a lot of hard work to be done and for this reason I am looking for teams and systems of varying degrees of readiness to do at least some of these tasks (e.g. plantuml - in terms of visualization of architectural code). Say, can you add to your documentation images of really practical application of your product, and even better would be an attached video. I still can't figure out if your system allows you to draw data models or sequence diagrams, maybe C4?
Reference Issues
No response