References - better non-coder readable display

Issue #53 resolved
Julien Heimann created an issue

I find the way copied references (of custom classes i think, just tested the demos) are displayed (the text) okay if i'm a programmer, and i think i understand why it's the way it is, but i think this could be better, more like "Reference to X in Y) or something similar, as it currently feels out of place compared to the general idea of 'keeping it clean and readable'.

Comments (4)

  1. Tor Esa Vestergaard
    • changed status to open

    Thanks for the suggestion! We concur, and have changed it to something simpler and less utilitarian, and also made sure the label of the actual field containing the reference is properly drawn. It now looks like this:

    Any thoughts or suggestions, or do you consider the issue resolved with this change?

  2. Julien Heimann reporter

    That looks a lot more readable already. The wording 'at path' and the curly braces still make me think that this is a translation of an internal data structure. I think what i'd prefer is something that i can map out easily in my mind; the, arguably, simplest representation: "Object Reference to: OtherObject.ItsObjectProperty.ItsObjectPropertyWithin" ,
    "Object Reference to: OtherObject.ItsDictionaryProperty(Index:'ItsIndex').ItsObjectProperty",
    "Reference to SomeObject within OtherObject in ItsListProperty at Index 'ItsIndex'"

    So, in essence keeping the dot notation consistent or alternatively 'at path', 'within' or similar as pure descriptive wording format.

  3. Tor Esa Vestergaard

    I think we're going to keep it as it is now - as we think that is the best balance between giving accurate, readable information, and keeping things simple for non-programmers.

  4. Log in to comment