[etoys-dev] Damage to More Objects chapter (renamed)
rita at isg.cs.uni-magdeburg.de
Fri Oct 19 04:40:36 EDT 2012
It is not the best idea to have this discussion on etoys-dev instead of squeakland, because just some of the contributors to the manual are subscribed to the dev list.
On Oct 18, 2012, at 5:58 PM, Edward Mokurai Cherlin wrote:
> I am in the middle of repairing extensive damage in the More Objects
> chapter (which I just now renamed from More Etoys Objects) of the
> Etoys Reference Manual. I find fragments of text from unidentified
> object descriptions, without section headings, and out of alphabetical
> order, all of which I have to track down and correct.
There is no "damage" to the "More Objects"chapter, since it never has been more than the collection of text taken out of the "objects" chapter. It has been in alphabetical order, though.
> Rita, is this your work? Has somebody else stepped in without talking
> to either of us? If so, please stop and let me do it instead.
I cleaned up the "objects" chapter to give it back the structure we intended it to have.
> information on Squeak implementations belongs either with the original
> object definitions, or in a separate chapter, which I am now leaning
Definitely. The information about Squeak implementation will confuse the many users of Etoys who are not going deeper into the system. So please remove this information from "objects" chapter, or I'll remove it again.
> We cannot divide it up so that the object is defined in the
> Objects chapter, and the information on its Squeak implementation is
> in the More Objects chapter.
What about adding a list of all objects to the "Appendix Morph Definitions" and put the implementation details there? Then we have the object and it's implementation in one place. And everyone can look up more about the object in either the "objects" or the "more objects" chapter.
Also, I would like to discuss the renaming of the chapters.
At the moment, we have "basic objects" and "more objects". I find it a bit confusing, since we also have the "basic" category in the object catalogue and this is not what the chapter is about. We divide the objects between the chapters based on where they are implemented. So we have the Etoys Objects and the morphs in Squeak.
My suggestion would be to name the chapter "Etoys Objects" and "Squeak Objects". But here I would like to hear the opinion of the developers. Does that make sense to you?
> I will have more to say when I finish surveying and correcting the damage.
> Edward Mokurai (默雷/निशब्दगर्ज/نشبدگرج) Cherlin
> Silent Thunder is my name, and Children are my nation.
> The Cosmos is my dwelling place, the Truth my destination.
> etoys-dev mailing list
> etoys-dev at squeakland.org
rita.freudenberg at ovgu.de
-------------- n�chster Teil --------------
Ein Dateianhang mit HTML-Daten wurde abgetrennt...
More information about the etoys-dev