Uploaded image for project: 'Help-Desk'
  1. Help-Desk
  2. HELP-7131

FIWARE.Request.Tech.Catalogue.Quality of Enabler documentation in the Catalogue / Guide compliance

    Details

    • Type: extRequest
    • Status: Closed
    • Priority: Major
    • Resolution: Done
    • Fix Version/s: 2021
    • Component/s: FIWARE-TECH-HELP
    • Labels:
      None
    • HD-Chapter:
      Catalogue

      Description

      Dear all,

      as part of our QA project, we measure also quality of Catalogue pages to help FIWARE QA team to validate compliance of published content with the Guide.
      Guide:
      https://forge.fiware.org/plugins/mediawiki/wiki/fiware/index.php/Working_with_the_FIWARE_catalogue#Guidelines_on_what_to_write

      Now we have established a first set of metrics and automated the measurement procedure.
      Whom to talk regarding validating the metrics themselves, especially their weighting as well as mapping to Labels?

      Metrics and weights established following the Guide (first edition!):
      https://github.com/sigspl/org.fiware.qa.documentation.measurements/blob/master/qa_docs_metrics.csv

      Measurement results:
      https://github.com/sigspl/org.fiware.qa.documentation.measurements/blob/master/enablers_data.csv

      Currently, best-rated Enablers get score of 34% which we consider to be D.

        Activity

        Hide
        davide Davide Dalle Carbonare added a comment -

        Dear Peter,
        are you already in contact with Clara (Atos), responsible of the FIWARE QA Team?
        I guess she is the best contact person to coordinate both testing activities and merge results.

        BR
        Davide

        Show
        davide Davide Dalle Carbonare added a comment - Dear Peter, are you already in contact with Clara (Atos), responsible of the FIWARE QA Team? I guess she is the best contact person to coordinate both testing activities and merge results. BR Davide
        Hide
        peter Peter Muryshkin added a comment -

        Okay, we will discuss this in the QA group anyway, I searched to contact the Guide Compliance owner, and supposed Clara was on vacations. But she seems to be back now.

        Show
        peter Peter Muryshkin added a comment - Okay, we will discuss this in the QA group anyway, I searched to contact the Guide Compliance owner, and supposed Clara was on vacations. But she seems to be back now.
        Hide
        peter Peter Muryshkin added a comment -

        Hi, Clara, please help, or we discuss this in the upcoming meeting, but this might be too much LoD so maybe we can discuss aside

        Show
        peter Peter Muryshkin added a comment - Hi, Clara, please help, or we discuss this in the upcoming meeting, but this might be too much LoD so maybe we can discuss aside
        Hide
        davide Davide Dalle Carbonare added a comment -

        Thank you Peter,
        I prefer you to coordinate with Clara first ...

        BR
        Davide

        Show
        davide Davide Dalle Carbonare added a comment - Thank you Peter, I prefer you to coordinate with Clara first ... BR Davide
        Hide
        cpezuela Clara Pezuela added a comment -

        Davide, the task commented by Peter has been agreed in the context of the QA task. It is in addition to what is being doing by ENG in functional testing, so it is part of the task workplan.
        Peter has defined a set of metrics that we just need to be confirmed by the person who did the complaince guide of the Catalogue, to be sure they are reasonable. I guess that this person was Stefano, since he was in charge of validating the Catalogue entraces in the past, but if you know who is currently or who could make this checking it would be very helpful
        Thanks

        Show
        cpezuela Clara Pezuela added a comment - Davide, the task commented by Peter has been agreed in the context of the QA task. It is in addition to what is being doing by ENG in functional testing, so it is part of the task workplan. Peter has defined a set of metrics that we just need to be confirmed by the person who did the complaince guide of the Catalogue, to be sure they are reasonable. I guess that this person was Stefano, since he was in charge of validating the Catalogue entraces in the past, but if you know who is currently or who could make this checking it would be very helpful Thanks
        Hide
        davide Davide Dalle Carbonare added a comment -

        Clara,
        thank you for the clarifications.
        Stefano is still currently in charge of reviewing the contents on the Catalogue (CAT-323).

        BR
        Davide

        Show
        davide Davide Dalle Carbonare added a comment - Clara, thank you for the clarifications. Stefano is still currently in charge of reviewing the contents on the Catalogue (CAT-323). BR Davide
        Hide
        cpezuela Clara Pezuela added a comment -

        Can we then re-assigned the ticket to him for checking the metrics?

        Thanks

        Show
        cpezuela Clara Pezuela added a comment - Can we then re-assigned the ticket to him for checking the metrics? Thanks
        Hide
        davide Davide Dalle Carbonare added a comment -

        Yes, I guess you can proceed in that way.

        Show
        davide Davide Dalle Carbonare added a comment - Yes, I guess you can proceed in that way.

          People

          • Assignee:
            Stefano Stefano De Panfilis
            Reporter:
            peter Peter Muryshkin
          • Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

            Dates

            • Created:
              Updated:
              Resolved: