[Moose-dev] Re: Quick Start User Experience

-- _,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;: Alexandre Bergel http://www.bergel.eu ^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;. On Aug 20, 2014, at 6:13 PM, stepharo stepharo@free.fr wrote: > Tx this is a great feedback > > On 20/8/14 14:37, Sean P. DeNigris wrote: >> I took the notes below while going through the chapter. In summary: >> - maybe RTTabTable is mis-packaged? >> - it's hard to keep written examples up-to-date with the code, especially >> when they are not automatically tested (of course in my dreams we only have >> active essays and never run into this problem, yet I digress...) >> - Code comments are key for when users want to drop into the code quickly >> from an example in the documentation to adapt it to our own needs >> - Nagging thought (not specific to the chapter): most of the Roassal >> examples I've seen illustrate procedural scripts. It might be nice to have >> more OOP examples, or if the point is to target >> non-programmers/Smalltalkers, at least a disclaimer saying that they're in >> script form for simplicity of copy/paste or whatever, but a real-world OOP >> example can be downloaded at... >> >> Roassal Quick Start says to visualize CSV data starting with RTTabTable, but >> shows the table plotted on a map, which does not fit my use case. It seems >> like I should be able to use the table not-on-a-map, but I see that it’s in >> the Builder-Map package, so I’m not so sure. In the end, that works out okay >> because I see that it’s reused in the Timeline example. >> >> Just as an experiment, I adapt the timeline example. Most of it is >> straightforward except the send of #normalizeSize:min:max:using: which was >> hardcoded and makes my data huge. I’d like to adjust it, but neither the >> method nor its class (RTMetricNormalizer) has a comment and I can’t figure >> it out from the example senders. Oh, well it was just an experiment… >> >> Next up, the charting example. First hurdle: >> #axisXNoLabelledWithNumberOfTicks: does not seem to exist in the system >> (fresh download from the link at the start of the chapter). I shorten it to >> axisXWithNumberOfTicks:, which works but the resulting chart is overcrowded >> with X axis labels. The example now works, but it’s hard to figure out >> what’s going on to adapt it to my use. For example, allY: is not a >> meaningful name to me and there is no method comment. >> >> HTH. >> >> >> >> ----- >> Cheers, >> Sean >> -- >> View this message in context: http://forum.world.st/Quick-Start-User-Experience-tp4773949.html >> Sent from the Moose mailing list archive at Nabble.com. >> >> _______________________________________________ >> Moose-dev mailing list >> Moose-dev@iam.unibe.ch >> https://www.iam.unibe.ch/mailman/listinfo/moose-dev > > _______________________________________________ > Moose-dev mailing list > Moose-dev@iam.unibe.ch > https://www.iam.unibe.ch/mailman/listinfo/moose-dev