Nikolai Pretzell wrote:
Hi Thomas,

 >>>I suppose that the IDL-Reference Properties are ordered at the moment
 >>>using the occurrence of the properties in the IDL-File. The good point
 >>>about this is that you can group together things like RightMargin and
 >>>LeftMargin but for someone who is looking for a property it would be
 >>>much more useful to have the properties sorted alphabetically.

I just tell some thoughts I have spontaneously.

Finding a Property
------------------

Let's see some use cases:

1. I know the property name and look for the documentation:

The reference has an index. There one can look for any property (or else) alphabetically ordered.

2. I am studying a service with <= 7 properties and look for a specific property:

For up to 7-8 properties there is not really a difference for the human brain, if they are anyhow ordered or not. The finding time is the same.
So the order by context (left,rigth etc.) makes sense.



3. I am studying a service with > 8 properties and look for a specific property:


Going back to the global index to search for the property is obviously unpleasant.
CTRL F in the browser will help.
But having an alphabetical list would be faster and more convenient.



The same three cases exist of course for searching methods in interfaces, interfaces in services, constants in constant groups etc.

I like the javadoc approach, where all the methods [fields, constructors] of a class are listed alphabetically in the overview section, but in "textual" order in the detailed list that follows the overview.


-Stephan

[...]

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Reply via email to