Ambiguous use of the word "changed" throughout Telerik documentation

1 posts, 0 answers
  1. Tim R
    Tim R avatar
    131 posts
    Member since:
    Feb 2006

    Posted 05 Dec 2012 Link to this post

    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.  

Back to Top