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.
The
information on Squeak implementations belongs either with the original
object definitions, or in a separate chapter, which I am now leaning
towards.
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?