On Sun, Jun 5, 2016 at 4:28 PM, Hilaire <[email protected]> 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-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 > >
