Skip to content

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.

Papyrus_Toolsmith_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.

Edited by Philip Schröder