Re: Diagram Descriptions in ArgoUML
Mark Fortner <[email protected]> Fri, 5 Aug 2011 10:56:25 -0700
| Newsgroups | gmane.comp.lang.uml.argouml.user |
|---|---|
| Message-ID | <CAOwy01sLLefcZcvrcuERANyAmXsoz5FN5YHyoYks7q4BmqyhCA@mail.gmail.com> |
------=_Part_21683_438675465.1312566987914 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Laurent: I like the idea of the "cartouche". I like the name too. It makes me think of Egyptian hieroglyphics. ;-) I also like the idea of being able to turn it on and turn it off. So if you were only producing diagrams, you might turn it on; if you were producing documentation you could turn it off. The wikipedia link you sent was pretty informative. Apparently it's a common practice when storing drawings. When the drawing is folded for storage, you can always see the cartouche, making it easy to search through a stack of drawings. The problem with comments is they are good for short notes of a few words, but not good for a couple of paragraphs. It takes up too much space on the diagram. For the same reason, I think the cartouche is excellent for small pieces of text, but probably ill-suited for a paragraph or more of text. Bob: I guess the other approach to storing the diagram descriptions would be to put them in the .argo file. There's already project metadata in there, we could simply add it to the body of the "member" tag. Mark On Fri, Aug 5, 2011 at 10:37 AM, Bob Tarling <[email protected]> wrote: > Certainly in UML1.4 there is nothing as diagrams are not actually part > of the specification. > > For UML2 we'd have to dig around the specs a bit more but even then we > will be a long way from diagram interchange formats when we have our > first UML2 release. > > Anything we do in ArgoUML will be argouml specific I think and stored > in the PGML file rather than any xmi file. > > Regards > > Bob > > On 5 August 2011 18:27, Laurent BRAUD <[email protected]> wrote: > > Hi, > > When I do some test with ArgoPrint in July, I have the same need. > > > > As it doesn't seems possible with ArgoUML, I wonder if we can do > something like: > > Add comments on diagram. If it's relies to an UMLElement, documentation > for UML Element, otherwise for the diagram. > > It's when I asked if possible to have 2 Diagram for one statemachine, and > I add that sometimes I could want one with comments and one without. I > suggest I will try to do this in argoprint. I have done a > getDiagramAsSVG_WithoutComment in DiagramUtil (I can give you if wanted), > but I haven't done get Comment for a diagram or a UMLElement. > > > > > > I don't think you like this, since you write :"Trying to put this in a > couple of > > paragraphs comment doesn't really work for me". > > > > You said about "a couple" and > > "describe"=> Why comments aren't enought. > > > > However I agree with you : I think it should be nice to add some comments > with a property. > > > > Moreover I think (But it's only my point of view) that someone comments > should be "standard", such it exist "cartouche" in "dessin technique" > (Sorry, don't know english word): > http://fr.wikipedia.org/wiki/Dessin_technique#Cartouche > > > > When print a UML diagram, I would like a "cartouche" with the > UMLVersion(instead of "mode de projection") because <> between UML1.x , the > create/modify date, The version of document... > > > > What's your opinion ? > > > > I have sometime now (and I'm curious to find) I find something in UML (I > will have a look in UML Diagram Interchange) > > > > Regards, > > Laurent. > > > > ------------------------------------------------------ > > > http://argouml.tigris.org/ds/viewMessage.do?dsForumId=449&dsMessageId=2809746 > > > > To unsubscribe from this discussion, e-mail: [ > [email protected]]. > > > > ------------------------------------------------------ > > http://argouml.tigris.org/ds/viewMessage.do?dsForumId=449&dsMessageId=2809750 > > To unsubscribe from this discussion, e-mail: [ > [email protected]]. > ------------------------------------------------------ http://argouml.tigris.org/ds/viewMessage.do?dsForumId=449&dsMessageId=2809755 To unsubscribe from this discussion, e-mail: [[email protected]]. ------=_Part_21683_438675465.1312566987914 Content-Type: text/html; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Laurent: I like the idea of the "cartouche". =A0I like the name t= oo. =A0It makes me think of Egyptian hieroglyphics. =A0;-) =A0I also like t= he idea of being able to turn it on and turn it off. =A0So if you were only= producing diagrams, you might turn it on; if you were producing documentat= ion you could turn it off. =A0The wikipedia link you sent was pretty inform= ative. =A0Apparently it's a common practice when storing drawings. When= the drawing is folded for storage, you can always see the cartouche, makin= g it easy to search through a stack of drawings.<div> <br></div><div>The problem with comments is they are good for short notes o= f a few words, but not good for a couple of paragraphs. =A0It takes up too = much space on the diagram. =A0For the same reason, I think the cartouche is= excellent for small pieces of text, but probably ill-suited for a paragrap= h or more of text.<br> <div><br></div><div>Bob: I guess the other approach to storing the diagram = descriptions would be to put them in the .argo file. =A0There's already= project metadata in there, we could simply add it to the body of the "= ;member" tag.</div> <div><br></div><div>Mark<br><div><br></div><div><br> <br><br><div class=3D"gmail_quote">On Fri, Aug 5, 2011 at 10:37 AM, Bob Tar= ling <span dir=3D"ltr"><<a href=3D"mailto:[email protected]">bob.tar= [email protected]</a>></span> wrote:<br><blockquote class=3D"gmail_quote" s= tyle=3D"margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;"> Certainly in UML1.4 there is nothing as diagrams are not actually part<br> of the specification.<br> <br> For UML2 we'd have to dig around the specs a bit more but even then we<= br> will be a long way from diagram interchange formats when we have our<br> first UML2 release.<br> <br> Anything we do in ArgoUML will be argouml specific I think and stored<br> in the PGML file rather than any xmi file.<br> <br> Regards<br> <br> Bob<br> <div><div></div><div class=3D"h5"><br> On 5 August 2011 18:27, Laurent BRAUD <<a href=3D"mailto:[email protected]= ">[email protected]</a>> wrote:<br> > Hi,<br> > When I do some test with ArgoPrint in July, I have the same need.<br> ><br> > As it doesn't seems possible with ArgoUML, I wonder if we can do s= omething like:<br> > Add comments on diagram. If it's relies to an UMLElement, document= ation for UML Element, otherwise for the diagram.<br> > It's when I asked if possible to have 2 Diagram for one statemachi= ne, and I add that sometimes I could want one with comments and one without= . I suggest I will try to do this in argoprint. I have done a getDiagramAsS= VG_WithoutComment in DiagramUtil (I can give you if wanted), but I haven= 9;t done get Comment for a diagram or a UMLElement.<br> ><br> ><br> > I don't think you like this, since you write :"Trying to put = this in a couple of<br> > paragraphs comment doesn't really work for me".<br> ><br> > You said about =A0"a couple" and<br> > "describe"=3D> Why comments aren't enought.<br> ><br> > However I agree with you : I think it should be nice to add some comme= nts with a property.<br> ><br> > Moreover I think (But it's only my point of view) that someone com= ments should be "standard", such it exist "cartouche" i= n "dessin technique" (Sorry, don't know english word): <a hre= f=3D"http://fr.wikipedia.org/wiki/Dessin_technique#Cartouche" target=3D"_bl= ank">http://fr.wikipedia.org/wiki/Dessin_technique#Cartouche</a><br> ><br> > When print a UML diagram, I would like a "cartouche" with th= e UMLVersion(instead of "mode de projection") because <> be= tween UML1.x , the create/modify date, The version of document...<br> ><br> > What's your opinion ?<br> ><br> > I have sometime now (and I'm curious to find) I find something in = UML (I will have a look in UML Diagram Interchange)<br> ><br> > Regards,<br> > Laurent.<br> ><br> > ------------------------------------------------------<br> > <a href=3D"http://argouml.tigris.org/ds/viewMessage.do?dsForumId=3D449= &dsMessageId=3D2809746" target=3D"_blank">http://argouml.tigris.org/ds/= viewMessage.do?dsForumId=3D449&dsMessageId=3D2809746</a><br> ><br> > To unsubscribe from this discussion, e-mail: [<a href=3D"mailto:users-= [email protected]">[email protected]</a>].<= br> ><br> <br> ------------------------------------------------------<br> </div></div><a href=3D"http://argouml.tigris.org/ds/viewMessage.do?dsForumI= d=3D449&dsMessageId=3D2809750" target=3D"_blank">http://argouml.tigris.= org/ds/viewMessage.do?dsForumId=3D449&dsMessageId=3D2809750</a><br> <div><div></div><div class=3D"h5"><br> To unsubscribe from this discussion, e-mail: [<a href=3D"mailto:users-unsub= [email protected]">[email protected]</a>].<br> </div></div></blockquote></div><br></div></div></div> ------=_Part_21683_438675465.1312566987914--