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, you can
write a bit more about writing spotter plugin, then in each plugin entry
write a human readable sentence explaining what does the plugin.
After all, from the Settings browser, each entry is just one shortcut
[alt]-b away.
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-extensions/
>
> 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
