Install Documentation
Dear Papyrus-team,
first of all, thank you for providing us with such a great software. This helps a lot in our own projects.
What would be even greater though, would be if there was some documentation describing what those tools are, which of them I would want to install and why.
I know that in software development there are deadlines and developers do not like writing documentation. But for me as a user, documentation is my top 1 priority to be able to use a product.
For instance, I would like to create UML-diagrams, UML-profiles and also new palettes with customized elements.
When installing through Eclipse "Install New Software"-wizard I got a dozen of different choices for installation. But as my disk space is quite limited concerning that there are a multitude of other tools that I also need, it would be great to know what to install.
For instance:
Tool: "Papyrus Diagram Generation Tools" Description: "Diagram Generation for Papyrus"
Sounds useful, but what are those diagrams generated from? Do I provide some script, what language, Python, Go, Groovy, Perl ? Is it for roundtrip engineering, when would I actually ever need it ? I do not know, so it comes down to guessing. It is also unclear when I have limited disk space if a feature that I see in the software was already there without those tools or if it is the result of installing those tools. So did I use additional disk space with an actual use for me and my team?
Then we have things like:
Tool: "Papyrus Toolsmiths - Builder Feature"
Description: "Papyrus Plug-Ins Validation Tools"
I guess this is a copied description from the item above named "Papyrus Plug-Ins Validation Tools" . And again, "Builder Feature" sounds great. I need to build stuff, probably useful. But it is always guessing. And I am working on a side-project in a small team, and I would like to be able to tell my team what we need, instead of "This sounds good, probably just install it".
So while I am grateful for your hard work, I would be much happier with less features but those thoroughly documented. Thank you for your time help and trouble.
Best regards
Philip.
