Line 496 - The term "gluon" is never defined.

    • Type: Bug
    • Resolution: Fixed
    • Priority: Major
    • wd29
    • Affects Version/s: wd26
    • Component/s: spec
    • None
    • Environment:

      David Haynes

    • Hide

      Gluon is a term that comes from a normative reference, repeatedly cited in specification and summarized in appendices. Citation was moved forward into section three, where it is harder to miss.

      Show
      Gluon is a term that comes from a normative reference, repeatedly cited in specification and summarized in appendices. Citation was moved forward into section three, where it is harder to miss.

      You should use industry standard terminology wherever possible in order to maximize understandability. If this is not possible for some reason, and a new term needs to be defined, then it must be defined in the documents where it is used, in an introductory section. If the definition is so large that it requires a document unto itself to define it, then it would be permissible to refer the reader to this document to obtain the definition. None of these steps were taken. The document assumes that the reader knows what a gluon is as used in its unique way. As it stands now, it is simply incomprehensible.

            Assignee:
            Toby Considine (Inactive)
            Reporter:
            Toby Considine (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved: