Thanks Doru :D

Whoops, I forgot to mention: I developed this project mostly in a Pharo1.1
version but not the last one, and when I tested it in the last 1.1 version I
noticed what you said:

- It looks like the last character from the name of the class gets trimmed
> - sometimes the last character from the names of the methods appears on the
> next row
>

But this is because of NewTextMorph>>fitToParagraph and it's fixed in Pharo
1.2, so I left it as that until the new Pharo dev version is ready :$

About the other things:

- I would prefer to have the menus for manipulating entities directly on the
> canvas, and not in the panes below
>

Great, I'm planning to do that, and also make the boxes editable, so you can
write and modify the text without using the little workspace below, and
Mariano suggested me to be able to browse classes from the boxes too. What
other features would you like to add specifically?

- When trying to create a box from existing class, I get DNU when the class
> does not exist. Here I would expect to have the option of selecting this
> class from a list, not to know it upfront
>

Oops, thanks, I'll check that. You can choose an existing class from a list
if that class is in the same package your documenting. I didn't do that for
any existing class because they would be too many. Do you think of a better
option? Maybe adding autocompletion of the class name?

- I would prefer another notation for interfaces vs. classes. Right now you
> have two borders on top of each other: solid for those entities that can
> hold code, and dotted for those that cannot be instantiated. I would prefer
> to have only one border with different thicknesses or different shades of
> gray to denote code, and italic text to denote abstractness (for traits and
> interfaces).
>

That's interesting and it's the kind of feedback I'm most looking for. I
chose dashed lines for things you can't instantiate because that's the
convention for interfaces in UML that I use at collage, and I thought of a
variant of that for trait boxes. But I'm not 100% sure about the styling I
chose. The same applies for arrows and the relationships lines.
A little note upside the boxes like <<trait>> or <<interface>> would work
also, although I'm afraid they could overlap with connections :/
I'll think about that, but I'd also like to have more opinions from the
(hopefully) future users :) Different colors or shades of gray / black could
work, I'd prefer not changing the border thickness between boxes.

And I chose underlined italic style for Class Instance Variables, but I'm
not sure about that either. The underline convention is for Class Variables,
but what about Class Instance Variables?



> I am not sure if it matters, but I have to mention that I tested in on a
> Pharo 1.1 on a CogVM.
>

That matters! Haven't tested CogVM yet, so... great :D


>
> Cheers,
> Doru
>
>
> On 19 Aug 2010, at 16:56, Carla F. Griggio wrote:
>
>  Hi everyone!
>> Well, here I am announcing the resulting project of my GSoC experience
>> during the [your] summer: smallUML, a project to help us building diagrams
>> and sharing them with any package of code.
>> My mentor was Stephane Ducasse and my co-mentor Geert Claes, so thanks to
>> them for the guidance up to now, and also to Fernando Olivero who helped me
>> a lot (hope to do some coding with you at ESUG! :P).
>>
>> You can gofer it:
>>
>> Gofer it
>>    squeaksource: 'smallUML';
>>    package: 'ConfigurationOfSmallUML';
>>    load.
>> (Smalltalk at: #ConfigurationOfSmallUML) project latestVersion load.
>>
>> And then open the Diagram Browser of the current little examples
>> evaluating:
>>
>> DiagramDrawingDocumentation openDiagramBrowser  .
>>
>> This is beta and I'm still working on it, my work will continue after
>> GSoC's deadline, so of course your welcome to give some feedback and think
>> about what features would you like it to have and if you're confortable with
>> the current features. It would be really nice if this helped to get all
>> Pharo projects more documented, with visual diagrams that help understanding
>> them at a glance.
>>
>> Talking about that... the current features are:
>>        • Open a Diagram Browser for an existing Category Diagrams Holder
>> (this is a class ment to hold the created diagrams and there should be one
>> per category, for now; you can browse DiagramDrawingDocumentation to see an
>> example)
>>        • Create and edit diagrams programatically describing them with
>> "diagram code" (the diagram code it's just a protocol of methods meant to
>> describe diagrams, you can see some diagram code browsing
>> DiagramDrawingDocumentation methods or each Class Box in the Diagram
>> Browser)
>>        • Every diagram you build through the Diagram Browser it's saved as
>> "diagram code", so you can share it as code that will reproduce your diagram
>> :) That means that diagrams can 'travel' along it's package when you commit
>> your changes with Monticello! And then they can be edited by anybody,
>> they're not just a pretty picture.
>>        • You can export your diagram as a PNG picture or you can export
>> it's "diagram code" as a workspace.
>>        • Only Class Diagrams can be built for now.
>>        • Class Boxes of a class diagram can be dragged to be easily
>> positioned.
>> Some details that are missing:
>>        • It's funny, but I can't center the class boxes title! :P
>>        • I tried adding some scrollbars to the "whiteboard" where you can
>> view your diagrams in the Diagram Browser, but if I did that the drag & drop
>> of the class boxes worked funny :( I'll ask about that to you later.
>> On the way:
>>        • Tests and documentation, and a screencast showing every feature.
>>        • Lots of refactors: as I'm adding more kind of diagrams right now,
>> so I'm doing a lot of refactors to make everything more flexible and
>> improving all the messy code there.
>>        • A version of Minimal Connectors for anybody to use if they feel
>> like connecting morphs for another project.
>>        • Some usability improvements.
>>        • Object diagrams
>>        • Sequence diagrams
>>        • Your feedback :D
>>
>> So I'd really appreciate if you can give it a try and tell me how you feel
>> about it, I'd like it to be very usable.
>>
>> Cheers!
>>
>> Carla
>>
>> _______________________________________________
>> Pharo-project mailing list
>> [email protected]
>> http://lists.gforge.inria.fr/cgi-bin/mailman/listinfo/pharo-project
>>
>
> --
> www.tudorgirba.com
>
> "In a world where everything is moving ever faster,
> one might have better chances to win by moving slower."
>
>
>
>
> _______________________________________________
> Pharo-project mailing list
> [email protected]
> http://lists.gforge.inria.fr/cgi-bin/mailman/listinfo/pharo-project
>
_______________________________________________
Pharo-project mailing list
[email protected]
http://lists.gforge.inria.fr/cgi-bin/mailman/listinfo/pharo-project

Reply via email to