Uploaded image for project: 'OASIS Open Document Format for Office Applications (OpenDocument) TC'
  1. OASIS Open Document Format for Office Applications (OpenDocument) TC
  2. OFFICE-2251

Value requirements - DDB for example - "Must be a positive integer."

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Closed
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: None
    • Fix Version/s: ODF 1.2
    • Component/s: OpenFormula
    • Labels:
      None
    • Proposal:
      Hide

      Rewrite value requirements in functions to state accepted values without the use of "must" and similar wording.
      Change parameter requirements expressed in semantics to be constraints wherever possible.

      Show
      Rewrite value requirements in functions to state accepted values without the use of "must" and similar wording. Change parameter requirements expressed in semantics to be constraints wherever possible.

      Description

      Value requirements aren't "must"/"shall", etc. The current text under parameters reads: "lifeTime: the number of periods that the depreciation will occur over. Must be a positive integer."

      No, we are defining the function and so state: "lifeTime: the number of periods that the depreciation will occur over. A positive integer."

      Such that if I have an evaluator that properly implements DDB, by definition it only accepts a positive integer for lifeTime.

      May seem like a small thing but the text becomes confusing when value types are may/will/must, etc. Simply state the requirement and then leave it alone.

      This is an example case. Will sweep for others.

        Attachments

          Activity

            People

            • Assignee:
              erack Eike Rathke (Inactive)
              Reporter:
              patrick Patrick Durusau
            • Watchers:
              0 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: