Uploaded image for project: 'Request For Comments'
  1. Request For Comments
  2. RFC-552

Provide extra information for each Science Pipelines repository

    XMLWordPrintable

    Details

    • Type: RFC
    • Status: Adopted
    • Resolution: Unresolved
    • Component/s: LSST
    • Labels:
      None

      Description

      In order to properly include in the product tree all packages resolved via lsst_distrib, it is necessary to provide the following information, in each package git repository:

      • Short name of the package, a text to display in the (yellow box) of the product tree (max 18 characters)
        • Suggestion: It could follow the namespace naming rules, but first letter capital
      • Key string, 2 to 7 character, it shall be unique, the shorter the better, it has to be used for automatic process building the product tree
        • Examples, JCAL for jointcal, ASTMT for astro_metadata_translator, DAFB for daf_butler,
      • Reference person(s), someone that has the best knowledge on that software package and is usually maintaining it, 2 references can be given
        • Proposed format: github_username (Full Name) [github_username (Full Name)]

       

      The proposal is to add this information in a file, my first thought is a info.yaml in the home folder of each repository.

        Attachments

          Issue Links

          is triggering

          Story - Created by Jira Software - do not edit or delete. Issue type for a user story. DM-17682 Update README template

          • To Do
          relates to

          Story - Created by Jira Software - do not edit or delete. Issue type for a user story. DM-4875 Give base an updated readme file

          • Done

          Story - Created by Jira Software - do not edit or delete. Issue type for a user story. DM-14875 What to add to the pipe_tasks readme

          • Done

          Story - Created by Jira Software - do not edit or delete. Issue type for a user story. DM-4619 Add README, CONTRIBUTING and GitHub summaries to each package

          • Won't Fix
          mentioned in

          Page Loading...

          Page Loading...

          Page Loading...

          Page Loading...

            Activity

            Ascending order - Click to sort in descending order
            30 older comments
            Hide
            Permalink
            gcomoretto Gabriele Comoretto [X] (Inactive) added a comment -

            If I understand correctly from the last comments, the only information we need is:

            • wbsowner
            • expert
            Show
            gcomoretto Gabriele Comoretto [X] (Inactive) added a comment - If I understand correctly from the last comments, the only information we need is: wbsowner expert
            Hide
            Permalink
            gcomoretto Gabriele Comoretto [X] (Inactive) added a comment - - edited

            I had a look to the milestone project (in lsst-dm) but I did not find any json with project names.

            John Swinbank can you indicate where I can find this information?

            Show
            gcomoretto Gabriele Comoretto [X] (Inactive) added a comment - - edited I had a look to the milestone project (in lsst-dm) but I did not find any json with project names. John Swinbank can you indicate where I can find this information?
            Hide
            Permalink
            swinbank John Swinbank added a comment - - edited

            Gabriele Comoretto [X] — sorry I didn't see your comment earlier.

            I think we discussed this at the DM-CCB yesterday. The only JSON file in https://github.com/lsst-dm/milestones is used to provide information about milestones. I'm not aware of any existing JSON file which defines project (product?) names, although I guess maybe https://github.com/lsst/repos/blob/master/etc/repos.yaml is close?

            Show
            swinbank John Swinbank added a comment - - edited Gabriele Comoretto [X] — sorry I didn't see your comment earlier. I think we discussed this at the DM-CCB yesterday. The only JSON file in https://github.com/lsst-dm/milestones is used to provide information about milestones. I'm not aware of any existing JSON file which defines project (product?) names, although I guess maybe https://github.com/lsst/repos/blob/master/etc/repos.yaml is close?
            Hide
            Permalink
            gcomoretto Gabriele Comoretto [X] (Inactive) added a comment -

            I think repos.yaml is used for build purposes. Add there information for documentation purpose is not the right thing in my opinion.

            Since I will be parsing README files in any cases, I think that this is the most suitable location for the (optional) display_name information, in addition to wbsowner and expert as concluded above.

            Show
            gcomoretto Gabriele Comoretto [X] (Inactive) added a comment - I think repos.yaml is used for build purposes. Add there information for documentation purpose is not the right thing in my opinion. Since I will be parsing README files in any cases, I think that this is the most suitable location for the (optional) display_name information, in addition to wbsowner and expert as concluded above.
            Hide
            Permalink
            gcomoretto Gabriele Comoretto [X] (Inactive) added a comment -

            As per DMCCB #3 discussion.

            Show
            gcomoretto Gabriele Comoretto [X] (Inactive) added a comment - As per DMCCB #3 discussion.

              People

              Assignee:
              ktl Kian-Tat Lim
              Reporter:
              gcomoretto Gabriele Comoretto [X] (Inactive)
              Watchers:
              Brian Van Klaveren, Gabriele Comoretto [X] (Inactive), John Parejko, Jonathan Sick, Kian-Tat Lim, Simon Krughoff, Tim Jenness, Wil O'Mullane
              Votes:
              0 Vote for this issue
              Watchers:
              8 Start watching this issue

                Dates

                Created:
                Updated:
                Planned End:

                  Jenkins

                  No builds found.