This is a migrated thread and some comments may be shown as answers.

Ambiguous use of the word "changed" throughout Telerik documentation

0 Answers 18 Views
Documentation and Tutorials
This is a migrated thread and some comments may be shown as answers.
Tim R
Top achievements
Rank 1
Tim R asked on 05 Dec 2012, 01:53 PM
In the Telerik documentation, the word "changed" is used ambiguously which results in a lack of clarity and concision. Here's an example of what I mean.  What does the following (hypothetical) sentence mean?

THE ROW HAS CHANGED.

Does it mean that focus has moved to a different row?  Or that the row has been modified?

How about the following event name:

RowChanging

Does it mean we are moving to a different row or that the row is undergoing modification?

It is difficult to know which meaning is intended; either meaning can make sense in context. In Windows control programming, we are working with a GUI paradigm where events can be triggered by focus moving elsewhere, but we are also working with an object-oriented paradigm where events are triggered when the underlying data objects undergo modification.  So it is very important to have clarity when speaking about "change" as it relates to data-driven GUI controls, where these two paradigms coincide.  

No answers yet. Maybe you can help?

Tags
Documentation and Tutorials
Asked by
Tim R
Top achievements
Rank 1
Share this question
or