jsr348
  1. jsr348
  2. JSR348-82

The definition of Dormant needs clarification

    Details

    • Type: Bug Bug
    • Status: Closed
    • Priority: Minor Minor
    • Resolution: Fixed
    • Component/s: Process Doc
    • Labels:
      None

      Description

      What is a "life cycle"? It's not defined elsewhere.

        Activity

        Hide
        pcurran added a comment -

        The full definition is:

        Dormant Specification (Dormant): A Specification that does not have an identified Specification Lead or Maintenance Lead. All Specifications become Dormant at the end of their life cycles.

        I agree that the second sentence is problematic. I know what it's trying to say - "all specs become Dormant when they become dormant" but that doesn't help much.

        We could just delete that sentence, but I'm not sure about the first one either. The intent of the second sentence is to suggest that there's a point at which all specs naturally reach a stable state (when no further work will be carried out on them.) However, this isn't captured in the first sentence. There may well be an identified ML. In fact there always is (the last Spec Lead) unless something has been brought to our attention. This doesn't mean that that person is actively maintaining, or ever will maintain the spec.

        What this should really say is something like "a spec that is not being actively developed." This would bring it more into line with the only usage of the term in the document, in section 5.1.1 RELINQUISHING OWNERSHIP, where we say "If no replacement can be found, or if the Transfer Ballot fails, then the PMO will declare the Specification to be Dormant and no further maintenance can be carried out."

        I'm going to rename this issue to "The definition of Dormant needs clarification."

        Show
        pcurran added a comment - The full definition is: Dormant Specification (Dormant): A Specification that does not have an identified Specification Lead or Maintenance Lead. All Specifications become Dormant at the end of their life cycles. I agree that the second sentence is problematic. I know what it's trying to say - "all specs become Dormant when they become dormant" but that doesn't help much. We could just delete that sentence, but I'm not sure about the first one either. The intent of the second sentence is to suggest that there's a point at which all specs naturally reach a stable state (when no further work will be carried out on them.) However, this isn't captured in the first sentence. There may well be an identified ML. In fact there always is (the last Spec Lead) unless something has been brought to our attention. This doesn't mean that that person is actively maintaining, or ever will maintain the spec. What this should really say is something like "a spec that is not being actively developed." This would bring it more into line with the only usage of the term in the document, in section 5.1.1 RELINQUISHING OWNERSHIP, where we say "If no replacement can be found, or if the Transfer Ballot fails, then the PMO will declare the Specification to be Dormant and no further maintenance can be carried out." I'm going to rename this issue to "The definition of Dormant needs clarification."
        Hide
        pcurran added a comment -

        Change the definition to:

        Dormant Specification (Dormant): A Specification that is not being actively developed and on which no further development is anticipated, or that the PMO has determined has no assigned Specification Lead or Maintenance Lead."

        Show
        pcurran added a comment - Change the definition to: Dormant Specification (Dormant): A Specification that is not being actively developed and on which no further development is anticipated, or that the PMO has determined has no assigned Specification Lead or Maintenance Lead."
        Hide
        pcurran added a comment -

        On second thoughts, it would be better to reverse the two cases in the definition, since the formal assignment of the Dormant label is more important than the informal usage "all specs become Dormant eventually..."

        So, the definition should read:

        "A Specification that the PMO has determined has no assigned Specification Lead or Maintenance Lead, or that is not being actively developed and on which no further development is anticipated."

        Show
        pcurran added a comment - On second thoughts, it would be better to reverse the two cases in the definition, since the formal assignment of the Dormant label is more important than the informal usage "all specs become Dormant eventually..." So, the definition should read: "A Specification that the PMO has determined has no assigned Specification Lead or Maintenance Lead, or that is not being actively developed and on which no further development is anticipated."
        Hide
        pcurran added a comment -

        Please implement the change in my last comment.

        Thanks...

        Show
        pcurran added a comment - Please implement the change in my last comment. Thanks...
        Hide
        eduardo added a comment -

        I have implemented the change suggested in the last comment in the thread

        Show
        eduardo added a comment - I have implemented the change suggested in the last comment in the thread

          People

          • Assignee:
            eduardo
            Reporter:
            Alex Buckley
          • Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

            • Created:
              Updated:
              Resolved: