On Sun, Jun 5, 2016 at 4:28 PM, Hilaire <hilaire@drgeo.eu> wrote:
Documentation always help :)
What information will be helpful ? I understand now your intend: you want to encourage people to discover the Spot settings and how to write your own search plugin, so you expose the source code plugin in the settings browser description. It does not strike me, and I find your web page more helpful. But again, only my perception.
Now, try to imagine the worst case scenario by playing the role of a student learning Pharo with MOOC. What information will be helpful for your given a few facts?
- you already discover Spot, and find the tools pretty cool. - you learn about the Setting browser, there you discover you can toggle Spot's option. What will be useful for you to understand what does the plugings. Then, do you first want to know what does the plugin or how to write your own?
May be in the settings browser, GT Spotter Extensions category,
Oh! Not seen that before. That is interesting!
you can write a bit more about writing spotter plugin,
Sounds like a good place for such info. Or a button or link to bring up a help topic.
then in each plugin entry write a human readable sentence explaining what does the plugin.
And a bit of executable code to launch a demo of the GUI effect.
After all, from the Settings browser, each entry is just one shortcut [alt]-b away.
There is such a large number of extensions, its easy to be overwhelmed. Perhaps the could be another level, and/or display so some common/easy to follow ones at the top of the list of settings. cheers -ben
One remark, why is there both: Trait>>#spotterSuperClassMethodsFor: and Class>>#spotterSuperClassMethodsFor:
The Trait one seems uneffective.
Hilaire
Le 05/06/2016 08:17, Tudor Girba a écrit :
make it easier for a newcomer to comprehend?
To get the conversation started, I put together a description of what they mean here: http://www.humane-assessment.com/blog/discovering-and-managing-spotter-exten...
What do you think? Does this clarify the problem for you? If yes, what information would be useful to have in the image to better communicate the intent?
-- Dr. Geo http://drgeo.eu