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