Comment 1 Anthony Hunter 2006-02-03 11:47:58 EST

Created attachment 34092 [details]
Article

Comment 2 Nick Edgar 2006-02-03 12:06:18 EST

+1.

Comment 3 Nick Edgar 2006-02-13 11:39:31 EST

This is a new framework going into the Platform in M5.  It's a push-down of a framework already in use in WTP.  Clients will want to know how to use it, so it would be nice to have this article published for M5.

Comment 4 Wayne Beaton 2006-02-13 12:59:14 EST

Created attachment 34585 [details]
Minor text edits

Minor spelling edits to the HTML file.

Comment 5 Wayne Beaton 2006-02-13 13:15:19 EST

The one thing that I had trouble with is the notion of sections. I had to go back in the document and re-read about section after I'd gotten about 3/4 of the way through. I would certainly benefit from a little more discussion around the concepts earlier in the document. What is a contributor and what is it for? What is a section? I gather from the images and discussion that a section is basically an editor for a single property. 

An introduction to your example would be helpful as well. 

Comment 6 Wayne Beaton 2006-02-13 13:16:09 EST

Created attachment 34588 [details]
Minor text edits.

Comment 7 Anthony Hunter 2006-02-13 14:04:34 EST

Created attachment 34598 [details]
Article

Comment 8 Anthony Hunter 2006-02-13 14:07:59 EST

Updated based on comments and I added some more text as requested.

Comment 9 Wayne Beaton 2006-02-13 15:35:09 EST

Must a section be a "composite surrounding a group of widgets" or can it be a "widget or a composite containing a group of widgets"? I assume the latter...

Comment 10 Wayne Beaton 2006-02-13 15:37:52 EST

Created attachment 34608 [details]
Minor edits

Comment 11 Anthony Hunter 2006-02-13 15:42:41 EST

Before:
"It is important to note that a section is simply a composite surronding a group of widgets."

After:
"It is important to note that a section is simply a composite. A composite can contain an infinite combination of widgets."

Would this be better?

Comment 12 Anthony Hunter 2006-02-13 15:48:15 EST

Created attachment 34609 [details]
Article

Comment 13 Wayne Beaton 2006-02-13 16:42:26 EST

(In reply to comment #11)
> "It is important to note that a section is simply a composite. A composite can
> contain an infinite combination of widgets."

Actually, if it is the case that it must be a composite, then the original works (with spelling corrections :-)). So I should then assume that a composite is required. That is, you can't just make a section be a Text all by itself?

Comment 14 Anthony Hunter 2006-02-14 09:21:40 EST

You could make the entire section a Text widget given that standard SWT createControls() provides the parent composite.

Comment 15 Aaron Digulla 2006-02-16 13:43:02 EST

May I suggest that you put this article online in the Eclipse Wiki?

That would make access and editing more simple :-)

Comment 16 Wayne Beaton 2006-02-17 23:00:53 EST

Agreed that we need to come up with a better way to edit articles. Perhaps you can take this to a new bug.

I'll put this live over the weekend or Monday depending on how the kids' hockey schedule consumes me...

Comment 17 Wayne Beaton 2006-02-19 23:13:49 EST

The article has been published.